home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 May / EnigmA AMIGA RUN 18 (1997)(G.R. Edizioni)(IT)[!][issue 1997-05][EAR-CD II].iso / recent2 / aemail.lha / aemail115 / AEMail.doc < prev    next >
Text File  |  1997-04-07  |  259KB  |  5,366 lines
  1.  
  2.                                 AEMAIL.DOC
  3.  
  4.  
  5. Name of Program: AEMail (Amiga E-Mail)
  6.  
  7. Version: 1.15 (BETA VERSION K)
  8. Release Date: April 5, 1997
  9.  
  10. Written By: John F. Zacharias
  11.  
  12. AEMail is copyright (c) 1996-97 by John F. Zacharias, all rights reserved.  
  13. Permission is given to Beta Testers to test and evaluate the program in 
  14. return for feedback on the use of the program and reporting of any bugs 
  15. encountered.
  16.  
  17.      AEMAIL SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE;
  18.      NO WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY
  19.      OR RESPONSIBILITY IS ASSUMED.
  20.  
  21. Installer and Installer project icon
  22. (c) Copyright 1995-96 Escom AG.  All Rights Reserved.
  23. Reproduced and distributed under license from Escom AG.
  24.  
  25. INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE;
  26. NO WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY
  27. OR RESPONSIBILITY IS ASSUMED.
  28.  
  29. This documentation is divided into the following Sections and sub-topics:
  30.  
  31.     I. PROGRAM PURPOSE
  32.  
  33.     II. SYSTEM REQUIREMENTS
  34.  
  35.         REQUIREMENTS
  36.         RESTRICTIONS
  37.         REGISTRATION
  38.  
  39.     III. INSTALLATION
  40.  
  41.     IV. CONFIGURATION
  42.  
  43.         TOOL TYPES
  44.             INTERLACE=YES
  45.             MAIL_DIR=directory-path
  46.             CONFIG=configuration-file
  47.             MAILCAP_DIR=directory-path
  48.             USERID=UserId
  49.             PASSWRD=your_password
  50.             DOMAIN=Domain_Name
  51.             FROM=your_email_address
  52.             REALNAME=your_real_name
  53.             REPLYTO=reply-email-address
  54.             ORGANIZATION=organization-name
  55.             POP_SERVER=your_POP_host
  56.             SMTP_SERVER=your_SMTP_host
  57.             EDITOR=call_line_for_your_editor
  58.             TCPLOG=name_of_log_file
  59.             DELETEMAIL=YES
  60.             FULLHEADER=YES
  61.             STRIPDUPS=YES
  62.             HDRINREPLY=YES
  63.             STARTNET=call_line_for_your_startnet_script
  64.             STOPNET=call_line_for_your_stopnet_script
  65.             AUTOCONNECT=YES
  66.  
  67.         CONFIGURATION SCREEN
  68.             Identity Page
  69.             TCP/IP Page
  70.             Default Path Page
  71.             Other Parameters Page
  72.  
  73.     V. STARTING AEMAIL
  74.         Starting AEMail
  75.         Using AEMail as a "MailTo" Agent
  76.  
  77.     VI. COMMAND ICON STRIP
  78.  
  79.         DISPLAY FOLDER LIST
  80.         DISPLAY ADDRESS BOOK
  81.         DISPLAY PREVIOUS MESSAGE
  82.         DISPLAY NEXT MESSAGE
  83.         SAVE MESSAGE TO FILE
  84.         PRINT SELECTED MESSAGES
  85.         DELETE/UNDELETE MESSAGE
  86.         COMPOSE A MESSAGE
  87.         SEND MESSAGE IMMEDIATELY
  88.         QUEUE MESSAGE FOR LATER DELIVERY
  89.         RETRIEVE MESSAGES
  90.  
  91.     VII. AEMAIL MENUS
  92.  
  93.         Project menu
  94.             Configuration...
  95.                 Open...
  96.                 Edit...
  97.                 Save
  98.                 Save As...
  99.                 Restore Default
  100.             Send Queued Mail
  101.             Iconify AEMAIL
  102.             About...
  103.             Quit...
  104.  
  105.         Folders menu
  106.             New...
  107.             Edit...
  108.             Delete...
  109.             Set Sort Key...
  110.             Remove DELETED Msgs
  111.  
  112.         Messages menu
  113.             Compose...
  114.             Reply...
  115.             Forward...
  116.             Edit...
  117.             Select None
  118.             Select All
  119.             Export...
  120.             Copy...
  121.             Transfer...
  122.             Print
  123.             Delete/Undelete...
  124.             Display Full Hdr
  125.             Incl Hdr in Resp
  126.  
  127.         Retrieve Msgs menu
  128.             From POP Host
  129.             From Local File...
  130.             Excl Dup Msgs
  131.             Delete Host Mail
  132.  
  133.         TCP/IP menu
  134.  
  135.             Start Net
  136.             Stop Net
  137.             TCP Logging File
  138.                 Active
  139.                 Purge
  140.                 Display/Edit...
  141.  
  142.     VIII. AEMAIL WINDOWS
  143.  
  144.         Configuration Window
  145.         Folder List Window
  146.         Message List Window
  147.         Folder Configuration Window
  148.         Set Sort Keys Window
  149.             Examples of Setting Sort Keys
  150.         Address Book Window
  151.         Message Display Window
  152.             Attachment Requester
  153.         Compose Message Window
  154.             Add Attachments Requester
  155.  
  156.     IX. AEMAIL FILES
  157.  
  158.         mailcap
  159.         configuration (s:aemail.cnfg)
  160.         folder.config
  161.         [folder_Name].config
  162.         .addrbook
  163.         .signature
  164.         Messages
  165.         TCP Trace Log File (TCPLOG)
  166.  
  167.     X. BUG REPORTS & SUGGESTIONS
  168.  
  169.     XI. ACKNOWLEDGEMENTS
  170.  
  171.     XII. IN CONCLUSION
  172.  
  173.  
  174. I. PROGRAM PURPOSE:
  175.  
  176.     AEMAIL is a mail client designed to read, process, compose and send
  177.     e-mail from an Amiga computer over the Internet.  It provides an
  178.     easy to use graphical interface designed specifically for the Amiga.
  179.     It connects to an Internet server through AmiTCP or any TCP/IP stack
  180.     compatable with AmiTCP.  This includes TermiteTCP and Miami.  It uses
  181.     the AmigaDOS editor, ed, or any other editor of the user's choosing
  182.     for developing email messages.  No other external programs or modules
  183.     are required. The POP3 and SMTP protocols are built into the program.
  184.  
  185.     The current version of AEMAIL supports attachments following the MIME
  186.     (Multipurpose Internet Mail Extension) outline in RFC 1341, 1521,
  187.     1524 (Mailcap files), and 1806 as well as UUENCODED attached files.
  188.     Not all of the features of MIME headers are fully supported and
  189.     exceptions will be noted in the documentation.
  190.  
  191.     AEMail can also be used as a "MailTo" agent in WWW browsers, such as
  192.     Voyager and AWeb, which allow the user to specify such an agent for
  193.     composing and sending email.
  194.  
  195.  
  196. II. SYSTEM REQUIREMENTS:
  197.  
  198.     REQUIREMENTS
  199.  
  200.         This program can run on any Amiga Operating Systen 2.1 and above.
  201.  
  202.         This program requires AmiTCP or a TCP/IP stack compatable with AmiTCP.
  203.         It has been tested with the 4.0 Demo Version of AmiTCP, but will
  204.         possibly run on earlier versions at level 2.0 or greater.  It also
  205.         has been tested under TermiteTCP and Miami which use a TCP/IP stack
  206.         that is compatable with AmiTCP.
  207.  
  208.         Other TCP/IP software may or may not be compatable with AmiTCP.  If
  209.         the software uses a socket library (bsdsocket.library) with calls that
  210.         are compatable with AmiTCP, it possibly will work.
  211.  
  212.         If you wish to display MIME attachments from within AEMAIL, you will
  213.         also need a 'Mailcap' file.  Specifications for how to set up a
  214.         mailcap file are given under the IX. AEMAIL FILES section below.  It
  215.         is possible to display attachments with either AmigaDos 2.x or 3.x.
  216.         Datatypes are not required for this display.
  217.  
  218.         A sample mailcap file is also provided in the archive.  This sample
  219.         mailcap file can be used without modification on any system running
  220.         under AmigaDos 3.0 or later since it uses multiview as the display
  221.         agent.  If you are using a version of AmigaDos before 3.0, you will
  222.         have to modify the mailcap file to specify your own favorite display
  223.         program for specific "Content Type/Subtypes".
  224.  
  225.     RESTRICTIONS
  226.  
  227.         Only one version of AEMail can be running at a time.  If you are using
  228.         AEMail as a "mailto" mail agent in a browser, you can not have AEMail
  229.         running when you invoke your browser if you expect to send any email
  230.         from your browser.  AEMail will be automatically loaded from the
  231.         browser when you click on a "mailto:" link.
  232.  
  233.         While AEMAIL appears to work fine with a standard configured AMIGA,
  234.         there are some possible problems with "system addons" that do not
  235.         behave correctly with AEMAIL.  One known problem is with the
  236.         "Click-To-Front" commodity as follows:
  237.  
  238.             If you have the "Click-To-Front" commodity active with a QUALIFIER
  239.             Tool type equal to NONE when you execute AEMAIL, the folder strip
  240.             will disappear the first time you double-click on any part of the
  241.             AEMAIL screen outside the folder strip area.  The reason for this
  242.             is that the folder strip window overlays the main AEMAIL window and
  243.             when you double-click outside this area, the folder strip window
  244.             will be pushed to the back.  Presently, the solution to the problem
  245.             is to change the QUALIFIER Tool Type to something other than NONE
  246.             or to deactivate the "Click-To-Front" commodity BEFORE executing
  247.             AEMAIL.
  248.  
  249.         Any other hack or commodity which automatically brings the current
  250.         window to front either when you click on it or when you pass the
  251.         cursor over it, will react the same as "Click-To-Front" commodity.
  252.         You will have to deactivate the commodity or hack when you run AEMail.
  253.  
  254.         Other system configurations may also cause problems with AEMAIL.  If
  255.         you encounter one of these, please send me e-mail describing the problem
  256.         and what "add-on" you were using.  If it is a public domain program,
  257.         it would be helpful if you included the program as an attached archive
  258.         to your message. (see Section VI, Command Icon Strip: Compose A
  259.         message).
  260.  
  261.         One other restriction is in the use of the editor.  The editor can
  262.         not relinquish control when it is called.  This is particularly a
  263.         problem with CygnusEd (CED) and if you plan to use CED you must use
  264.         the activator program, ED with the option -sticky, or the supplied 
  265.         script, "s:AEMced.scr".  The script calls CED directly with a stack 
  266.         size of 12000 and the option -keepio.  Both options keep CED in 
  267.         control while you are performing the edit.  You need a script for
  268.         the direct call to CED if you use the -keepio option, because
  269.         CED requires a stack size of at least 8000.  The Install script
  270.         automatically handles this if you allow the Install to configure
  271.         AEMail.
  272.  
  273.         If you are having problems with other editors and stack size, you
  274.         can use the script and modify it to your specifications.  One warning,
  275.         however, if you call a word processor you will need to ALWAYS save
  276.         the file as ASCII.
  277.  
  278.         You can send me e-mail by using the Address Book Nickname AEMAIL.
  279.         (see also Section X, Bug Reports and Suggestions)
  280.  
  281.     REGISTRATION
  282.  
  283.         AEMail is now shareware.  Versions prior to 1.15 were "freeware".
  284.         A shareware fee of $30 is requested for AEMail.  The shareware 
  285.         fee (US Funds only) should be sent to:
  286.  
  287.             John Zacharias
  288.             10004 Vanguard Drive
  289.             Sacramento, CA 95827
  290.             USA
  291.  
  292.         You must include your Real Name and email address with your 
  293.         remittance.  A handy form has been provided in the file 
  294.         "registration.form" which you can print out and use for this 
  295.         purpose.  If you have more than one email address with more 
  296.         than one AEMail_Mail directory, please include ALL these addresses
  297.         on the "registration.form".
  298.  
  299.         Your registration will be acknowledged by email that must be 
  300.         received by AEMail.  AEMail version 1.15 does not have any features 
  301.         that are not implemented for non-registered users; however, future 
  302.         versions will have enhancements that will only be available to 
  303.         registered users.
  304.  
  305.         For the un-registered "Freeware" version, permission is given to to 
  306.         test and evaluate the program in return for feedback on the use of 
  307.         the program and reporting of any bugs encountered.
  308.  
  309.         I do ask, however, that, in return for the use of this product, you
  310.         inform me of any suggestions you have and of any bugs that you
  311.         encounter.  You can do that by sending e-mail to me using the
  312.         Nickname AEMAIL which can be found in your Address Book when you
  313.         first load AEMail. (see also Section X, Bug Reports and Suggestions)
  314.  
  315.    --------------------------------------------------------------------------
  316.      WARNING  WARNING  WARNING  WARNING  WARNING  WARNING  WARNING  WARNING
  317.    --------------------------------------------------------------------------
  318.  
  319.         When you send your first message with any new version of AEMail, 
  320.         a special "Notification" message will be sent to me at 
  321.         jzachar@calweb.com.  Besides the normal header information, 
  322.         the body of this message will contain the following information
  323.         (obtained from your configuration file):
  324.  
  325.             Your email address
  326.             Your Real Name
  327.             Your POP3 Server name
  328.             Your SMTP Server name
  329.             Your SMTP Domain Name
  330.             Your editor call
  331.             Your Display ID (from the screen mode setting)
  332.             Your Overscan Type (from the screen mode setting)
  333.             Base configuration file name
  334.             Currently active configuration file name
  335.             Mail Directory
  336.  
  337.         This information is provided to help me determine and debug 
  338.         problems with AEMail. Future versions may contain more or less 
  339.         information as the need arises.
  340.  
  341.         Most of the Internet information is public information and can be 
  342.         obtained from your service provider.
  343.  
  344.         I WILL KEEP THIS INFORMATION IN STRICT CONFIDENCE.  IF YOU DO NOT 
  345.         WANT THIS INFORMATION DIVULGED TO ME, DO NOT USE AEMAIL!
  346.                                               -----------------
  347.  
  348.         I am including this warning because of concerns expressed to me 
  349.         by some people.
  350.  
  351.    --------------------------------------------------------------------------
  352.      WARNING  WARNING  WARNING  WARNING  WARNING  WARNING  WARNING  WARNING
  353.    --------------------------------------------------------------------------
  354.  
  355.         This "notification" message will also give me the opportunity to inform 
  356.         all users of updates to AEMatl by e-mail.
  357.  
  358.         The notification message will not appear in your PENDING folder although
  359.         you will see it in your SENT folder after the notification message has 
  360.         been sent.  You will not have an opportunity to change any of the 
  361.         information.  If you feel some of the information is in error, you 
  362.         can correct it by sending me a separate email message.
  363.  
  364.         Please note that a new notification message will be sent when you
  365.         upgrade to a new version of AEMail.  This lets me know which version
  366.         you are using.  Some of the data in future notification messages may
  367.         also change to help give me feedback on how AEMail is being used and
  368.         what setup you are using.
  369.  
  370.         Also, if you are using multiple configuration files, a separate 
  371.         notification message will be sent the first time you send mail with
  372.         any particular configuration.
  373.  
  374.  
  375. III. INSTALLATION:
  376.  
  377.     PLEASE NOTE:  If you are installing from a diskette, your AEMail 
  378.     installation disk must NOT be write protected when you install AEMail.  
  379.     It will be written to during the install.
  380.  
  381.     An installation script using Amiga Technologies' Installer program, has 
  382.     been provided for the installation of AEMail.
  383.  
  384.         Installer and Installer project icon
  385.         (c) Copyright 1995-96 Escom AG.  All Rights Reserved.
  386.         Reproduced and distributed under license from Escom AG.
  387.  
  388.     To install AEMail simply double click on the "Install_AEMail icon".  The
  389.     install script provides three user levels that the user can choose:
  390.  
  391.         Novice          (no control - all defaults will be taken)
  392.         Intermediate    (control of configuration parameters)
  393.         Expert          (control of configuration and where files are placed)
  394.  
  395.  
  396.     The Install script makes an attempt to determine which TCP/IP stack that
  397.     you have installed.  This controls which defaults will be taken.  The
  398.     way the install scripts knows which TCP/IP stacks are present is as 
  399.     follows (you must have installed the particular stack before installing
  400.     AEMail):
  401.  
  402.         AmiTCP:     This is controlled by the presence of the AmiTCP: assign
  403.                     statement and the presence of the AmiTCP:bin drawer.
  404.  
  405.         Miami:      This is controlled by the presence of the Miami: assign
  406.                     statement.  When you installed Miami you should have let
  407.                     the install create the Miami: assign.  This was only
  408.                     available under later versions of Maimi.
  409.  
  410.                     While the Miami: assign is not an absolute requirement
  411.                     if you are using Miami, it is required if you intend
  412.                     to use the supplied "startnet.miami" and "stopnet.miami"
  413.                     scripts supplied with this archive.  The scripts will
  414.                     not even be moved to your AEMail drawer if the Miami:
  415.                     assign is not present.
  416.  
  417.         TermiteTCP: This is controlled by the presence of the TermiteTCP.prefs
  418.                     envronomental variable.  Also, if you want to pick up
  419.                     some of the other TermiteTCP variables, such as email
  420.                     address, you must have run TermiteTCP prior to installing
  421.                     AEMail (TermiteTCP does not have to be online, however).
  422.  
  423.     The action that takes place at the Novice level is slightly different
  424.     depending on whether AmiTCP has been installed or not.  The installation
  425.     script determines if AmiTCP is installed by checking for an assignment
  426.     to AmiTCP:. This AmiTCP: assignment was automatically created when you
  427.     installed AmiTCP.
  428.  
  429.     The AmiTCP: assignment determines where the installation script will
  430.     place the AEMail executable.  For AmiTCP the executable is placed in
  431.     the AmiTCP:bin drawer.  If it is not present, the placement of the
  432.     executable defaults to an AEMail drawer (created by the script if it
  433.     does not already exist) on the largest partition on your hard drive.
  434.  
  435.     If you wish to control where AEMail will be placed, you will need to
  436.     execute the Install script at the "Expert" user level.
  437.  
  438.     The reason that AEMail is placed in the AmiTCP:bin drawer is that the
  439.     assumption is made that you are using AmiTCP.  The "startnet" and
  440.     "stopnet" scripts should be in the same directory that contains AEMail
  441.     if they are to work without modification.
  442.  
  443.     If you select the Novice user level you will not be able to give any input
  444.     for the install.  The following actions will automatically be taken:
  445.  
  446.         The AEMail executable file will be placed in AmiTCP:bin or, if the 
  447.             AmiTCP: assignment is not present, on the largest partition on 
  448.             your hard drive.
  449.  
  450.             Note: No special directory will be created if AmiTCP:bin is
  451.             present, otherwise a directory called "AEMail" will be created 
  452.             for containing the AEMail executable.  When the installation 
  453.             script terminates it will tell you where it placed the AEMail 
  454.             executable.
  455.  
  456.             The AREXX scripts StartNet.Miami and StopNet.Miami will also
  457.             be moved to this drawer if you have Miami installed on your
  458.             system.
  459.  
  460.         Your AEMail mail directory will normally be a directory called
  461.             AEMail_Mail in AmiTCP: or, if the AmiTCP: assignment was not 
  462.             present, in the AEMail directory. The AEMail mail directory 
  463.             will be assigned to AEMAIL:.  If an AEMAIL: assignment already
  464.             exists, that directory will be used as the mail directory. 
  465.             This operation is automatic and makes updating the AEMail program
  466.             easy without disturbing your existing mail files.
  467.  
  468.         No configuration will be performed.  However, certain default
  469.             configuration values will be provided (see below).  This will
  470.             include the appropriate Start Net and Stop Net scripts for
  471.             the TCP/IP stacks that you are running.  Miami takes precedence
  472.             over AmiTCP.
  473.  
  474.         All of the documentation files will be copied to the same drawer
  475.             in which the AEMail executable was copied to.
  476.  
  477.         If you are running under AmigaDos 3.0 or greater, the supplied
  478.             mailcap file will be copied to the AEMail_Mail directory.
  479.             No mailcap file will be copied if you are using AmigaDos 2.1.
  480.  
  481.         An AEMAIL: assign statement will automatically be placed in your
  482.             S:User-Startup file.
  483.  
  484.         An "ASSIGN C: SYS:REXXC ADD" will also be added to your s:User-Startup
  485.             file to provide a path to your AREXX commands.
  486.  
  487.     If you select the Intermediate user level you will also be able to provide
  488.     configuration data that will be stored in the Tool Types parameters of
  489.     the AEMAIL icon.  Further, if the AEMAIL: assignment existed at the start
  490.     of the installation that assignment will be used.  However, if the mail
  491.     directory had been called something else, you will be asked if you want
  492.     to rename it to AEMail_Mail.  If you select NO, the directory will not
  493.     be renamed; however, a new AEMail_Mail directory will be created in the
  494.     same parent directory and used for the AEMAIL: assignment.
  495.  
  496.     In addition to what is available for the Intermediate user, the Expert
  497.     user will be able to select what directories will be used and will be
  498.     able to copy the documentation files to a directory of his/her choice.
  499.     The Expert user will also be able to select an alternate location for a
  500.     pre-existing mailcap file and, if running under AmigaDos 2.1, will be
  501.     able to build their own mailcap file.
  502.  
  503.     The installation script will try to automatically configure certain
  504.     items to default values.  These include the switch for deleting mail
  505.     from your POP Server once the mail has been transferred to your Amiga 
  506.     and the switch for stripping duplicate messages.  The edit call will
  507.     default to c:ed and will open the editor on the Workbench.  Also,
  508.     if you installed TermiteTCP, the installation script will obtain your
  509.     POP3 UserID and SMTP Domain Name as well as your email address from 
  510.     the ttcp-email-address environmental variable provided TermiteTCP 
  511.     has been run (not necessarily on-line) before the AEMail installation 
  512.     was performed.
  513.  
  514.     The installation script at the Intermediate and Expert user levels will
  515.     allow you to provide additional configuration parameters as Tool Types
  516.     in your AEMail icon or to change the default ones.  However, if you are
  517.     updating from a prior version you may already have an aemail.cnfg file
  518.     in your S: directory which will override the Tool Types.  If the
  519.     S:aemail.cnfg file is present, you will be asked if you want to use 
  520.     it or if you want to re-configure using tool types.  If you select
  521.     this option your current s:aemail.cnfg file will be deleted and you
  522.     can reconfigure through the installation script.
  523.  
  524.     If these parameters are not provided by Tool Types (through the installation
  525.     script) or by an existing configuration file, the Edit Configuration screen 
  526.     will be displayed upon the initial startup of AEMail.  You can not proceed
  527.     beyond this configuration screen until certain required configuration
  528.     parameters are provided.  The absolute minimum configuration parameters
  529.     that must be provided are:
  530.  
  531.         POP3 UserID
  532.         Password
  533.         Your email Address
  534.         SMTP Domain Name
  535.         Edit Call
  536.  
  537.     A POP Server name and a SMTP Server name must also be provided.  However,
  538.     if they are missing AND, if the SMTP Domain Name has been specified, 
  539.     default values will be assigned to these items.  These default values
  540.     will prepend 'POP." to the domain name for the POP server and 'SMTP.' 
  541.     to the domain name for the SMTP Server as defaults.  Please note: these
  542.     may NOT be correct for your POP and SMTP servers.  If they are not,
  543.     you will have to edit the Configuration and make appropriate changes (see
  544.     Configuration Parameters for Identify under Section IV. Configuration).
  545.  
  546.     If you have installed and ran TermiteTCP before you installed AEMail, 
  547.     the only configuration parameter you may have to provide is your password.  
  548.     The POP3 UserID and the SMTP Domain Name are extracted from the email 
  549.     address that you gave TermiteTCP.  If these are not the correct values 
  550.     you will have to change them in the Identity page of the Configuration 
  551.     screen.
  552.  
  553.     For AmiTCP or Miami users, you will need to provide your POP3 UserID 
  554.     and SMTP Domain name as well as your email address.
  555.  
  556.     One of the things that is needed to run AEMail is an editor.  By default
  557.     AEMail will use the AmigaDOS editor, ed, which comes with all Amigas.
  558.     However, you can change this through the install to any editor that 
  559.     you want provided that you have specified that you want to configure
  560.     AEMail when you do the the install.
  561.  
  562.     Special considerations have to be made if you want to use CygnusEd (CED) 
  563.     as your editor.  The installation script will automatically handle this 
  564.     by asking if you are using CygnusEd.
  565.  
  566.     If you are using AmiTCP, it is recommended that you place AEMail in the
  567.     same directory that contains your AmiTCP StartNet and StopNet scripts
  568.     (usually AmiTCP:bin) although this is not an absolute requirement.  If
  569.     the directory containing your StartNet or StopNet scripts is NOT the
  570.     AmiTCP:bin directory or the scripts have names different from "startnet"
  571.     or "stopnet", you will have to add the STARTNET and STOPNET tool types
  572.     to your AEMail icon.  You can do that with the installation script at
  573.     either the Intermediate or Expert user levels.
  574.  
  575.     If you are using TermiteTCP, there are no Start Net or Stop Net scripts.
  576.  
  577.     For Miami, special startnet.miami and stopnet.miami scripts have been
  578.     provided with the install of AEMail.  If the Miami assign is present,
  579.     the install script assumes the Miami startnet and stopnet scripts should
  580.     be used over the AmiTCP ones.
  581.  
  582.     SPECIAL NOTE FOR MIAMI USERS:  In the TCP/IP Settings page on Miami, the
  583.     "Down when Offline" item should be checked and the settings SAVED.  If
  584.     this item is not checked, it will take AEMail 80 seconds to determine
  585.     that Miami is offline if Miami is loaded but not online.
  586.  
  587.     The installation script will automatically create a directory for your
  588.     email storage (mail and configuration files) and place TWO ASSIGN 
  589.     statements in your S:User-Startup file as follows:
  590.  
  591.         ASSIGN AEMAIL: [your-mail-directory-path]
  592.         ASSIGN C: SYS:REXXC ADD
  593.  
  594.     The second assign statement is used to provide a path to your AREXX
  595.     commands because the only paths visable when you run a program from
  596.     the Workbench are the program directory and C:.
  597.  
  598.     If you are using AmiTCP (as determined by the presence of the AmiTCP:
  599.     assignment), the default directory that is created is AmiTCP:AEMail_Mail;
  600.     otherwise, it will be a directory called AEMail_Mail in the AEMail 
  601.     directory that has been created.
  602.  
  603.     If an AEMAIL: assignment already exists, the AEMail_Mail directory will 
  604.     not be created nor will the existing mail or Configuration files in the
  605.     directory be disturbed.
  606.  
  607.     If you want to place the AEMail_Mail directory some place else you will
  608.     have to specify the Expert user level when you perform the installation.
  609.  
  610.     The mail directory can start out empty.  The AEMail program will generate
  611.     any necessary configuration and support files required.  The AEMail_Mail
  612.     directory can be anywhere on any one of your hard drive partitions (or
  613.     on a floppy or other read/writable media); it does not have to be in
  614.     the AmiTCP: directory; but it must be mounted when you execute AEMail.
  615.  
  616.     Special Note on Use of multiple configuration files:  The normal AEMail
  617.     configuration file is s:aemail.cnfg.  With version 1.13 you will be able
  618.     to assign your configuration file to some other name and location (you
  619.     will need the Expert user level to do this).  and this will become your
  620.     base configuration.  Also, the installation will ONLY configure this 
  621.     base configuration.  You will have to use the Configuration screen to 
  622.     configure any other configuration files for other users.  See 
  623.     Section IV., Configuration, for other multiple user considerations.
  624.  
  625.     As stated above, you will need a "mailcap" file if you want to display
  626.     MIME mail attachments.  A sample mailcap file is provided on the AEMail
  627.     program disk which uses MultiView to display audio, images, and video
  628.     content types provided that you have the appropriate datatypes loaded
  629.     into your system.  This, of course, requires AmigaDos 3.0 or higher.
  630.     If you are using AmigaDos 2.1, the mailcap file needs to be modified to
  631.     reflect the display programs that you want.  The installation script at
  632.     the Expert level will help you do this.
  633.  
  634.     If you are running under AmigaDos 3.0 or higher, the installation script
  635.     will automatically move the supplied mailcap file to AEMAIL: unless
  636.     you specified a different location for a pre-existing mailcap file (Expert
  637.     level only).
  638.  
  639.     The mailcap file specifications are given in Section IX, AEMail Files:
  640.     mailcap.
  641.  
  642.     When the installation script terminates it will store the directory in 
  643.     which it placed AEMail in the Environmental variable AEMail_dir.  This 
  644.     facilitates updating to future releases of AEMail.  The version 1.13
  645.     installation script, at all installation levels, will look for this 
  646.     Environmental variable to try to determine where to place AEMail.
  647.  
  648.     HANDLING OF TIME ZONES IN AEMAIL
  649.     --------------------------------
  650.  
  651.     AEMail will handle time zones in both full hour and half hour increments.
  652.     AEMail uses either the "tz" environmental variable, a special "aem_tz"
  653.     environomental variable, or the "locale.prefs" file that is part of 
  654.     AmigaDos to determine your local time zone.  The "locale.prefs" file will
  655.     only allow for full hour time zone offsets.  You can use the "tz" 
  656.     environmental variable for half hour time zones, but, if this variable
  657.     is used by other programs in your system it is suggested that you use
  658.     the "aem_tz" variable instead.
  659.  
  660.     Currently AEMail first looks for the environmental variables "aem_tz" or
  661.     "tz".  The format for "tz" is dictated by SAS_C and should be aaabbbccc 
  662.     where aaa is the abbreviation for local standard time, bbb is the offset 
  663.     in hours from GMT (-11 to 12) which is SUBTRACTED from GMT to get the 
  664.     local standard time.  ccc is the abbreviation for local daylight savings 
  665.     time or "summer time" (in the United Kingdom or Europe).  If the time zone 
  666.     has daylight savings time this should be present even if daylight savings
  667.     time is not currently in effect (contrary to the specification for "Tz"
  668.     for the SAS-C compiler).  AEMail automatically determines when DST or
  669.     "Summer Time" is in effect.
  670.  
  671.     AEMail also recognizes an alternate form of "tz" where aaa and ccc can be
  672.     abreviations longer than 3 characters.  This is desireable in some
  673.     European countries.  AEMail will also recognize time zones in increments
  674.     of one half hour.  To specify an half hour time zone, specify it as + or
  675.     - hhmm.  As an example:  +230 would specify a time zone in which 2 and a
  676.     half hours are SUBTRACTED from GMT.
  677.  
  678.     You can enter the above with the "tz" environmental variable, but since 
  679.     this variable might be used with other programs in it's strict sense, an
  680.     alternate environmental variable has been provided called "aem_tz".
  681.  
  682.     If "aem_tz" is present it will take precedence over "tz".
  683.  
  684.     If the "tz" or "aem_tz" environmental variables are not present, 
  685.     the system then attempts to get the time zone offset from the 
  686.     "locale.prefs" file.  Only the time zone offset is present in this 
  687.     file.  The abbreviations for local standard time and daylight savings 
  688.     time are obtained from a table that is by no means complete.  Only the 
  689.     time zone abbreviations for the United States, Canada, and the United 
  690.     Kingdom are contained in this table, so one of the environmental variables
  691.     is preferred.
  692.  
  693.     if neither the "tz" nor "aem_tz" environmental variables nor the 
  694.     "locale.prefs" file are present, the system defaults to CST with an 
  695.     offset of 6.
  696.  
  697.     NOTE: the standard header in an email message has the time zone offset sign
  698.     reversed from that of the "locale.prefs" and the environmental variables.
  699.     AEMail automatically makes this reversal, so the offset should be set to
  700.     positive for US time zones and negative for European time zones.  They 
  701.     will appear as negative (for US) and positive (for Europe) in the Date:
  702.     header.
  703.  
  704.     You can set the "tz" or the "aem_tz" environmental variables by using 
  705.     the SETENV AmigaDos Command.  This must be done from the shell.  The 
  706.     syntax to use is as follows:
  707.  
  708.         SETENV tz aaabbbccc                            (for tz) and
  709.         SETENV aem_tz aaaaaaaaabbbbbccccccccc          (for aem_tz)
  710.  
  711.     aaa, your local time zone abbreviation must always be present.  If you 
  712.     don't know your abbreviation (or don't want it in the header), use "xxx".
  713.     If AEMail sees xxx it will assume that no abbreviation is present and 
  714.     it will be left off the Date: header
  715.  
  716.     bbb is the time offset in hours from GMT.  Plus indicates that you are west
  717.     of GMT and minus indicates that you are east of GMT.  Acceptable values are
  718.     -12 to 24.  If you want to specify a half our time zone it can be entered
  719.     as hhmm.  If AEMail sees a value of 30 or above it assumes that a half hour
  720.     increment is being used.  In this case -1200 to 2400 are acceptable.
  721.  
  722.     If your time zone observes daylight savings time, ccc is the abbreviation to
  723.     use for daylight savings time.  If ccc is not present, no adjustment will be
  724.     made during the times of the year that daylight savings time is observed.
  725.  
  726.     The result of the SETENV command is only in effect while your computer is on.
  727.     If you want to make the "tz"or "aem_tz"  environmental variables always 
  728.     present enter the one of the following AmigaDOS command after the SETENV 
  729.     command:
  730.  
  731.         COPY ENV:tz ENVARC:tz                          (or)
  732.         COPY ENV:aem_tz ENVARC:aem_tz
  733.  
  734.     Using the "tz" or "aem_tz" environmental variables gives you more control 
  735.     over which abbreviations will be used for your time zone.  However, the 
  736.     locale.prefs file may be more useful for those that prefer the "point and 
  737.     click" method of doing things.  To set the correct time zone for 
  738.     locale.prefs, enter the Locale editor in your Prefs drawer.  You will 
  739.     see a time zone map with which you can move the white strip indicating 
  740.     the time zone on the map.  Click either to the left or right of the strip 
  741.     to move the strip.  The correct time zone offset for standard time will be 
  742.     shown at the top of the map.
  743.  
  744.     Since the locale.prefs does not have any abbreviations, AEMail makes certain
  745.     assumptions as to what the abbreviation should be.  These assumptions are as
  746.     follows:
  747.  
  748.     Time Zone Name           Standard    DST  -----------Time Zone-----------
  749.                              Time             (in "locale")  (in email Date:)
  750.  
  751.     Greenwich Mean Time      GMT*        BST       0              +0000
  752.  
  753.     Atlantic Time            AST         ADT       4              -0400
  754.     Eastern Time (US)        EST         EDT       5              -0500
  755.     Central Time (US)        CST         CDT       6              -0600
  756.     Mountain Time (US)       MST         MDT       7              -0700
  757.     Pacific Time (US)        PST         PDT       8              -0800
  758.     Yukon Time               YST         YDT       9              -0900
  759.     Hawaiian Time            HST         ---      10              -1000
  760.  
  761.     International Date Line  IDL         ---      12              -1200
  762.  
  763.     --- indicates this time zone does not observe DST
  764.  
  765.     *Note:  GMT (Greenwich Mean Time) is also known as UTC or Universal
  766.     Time Coordinated.
  767.  
  768.     If you want to use a different abbreviation or control whether DST is used
  769.     or not, you should use the "tz" or "aem_tz" environmental variable.
  770.  
  771.     DST in the United States and Canada begins on the first Sunday in
  772.     April.
  773.  
  774.     "Summer Time" in the United Kingdom and Europe begins on the last
  775.     Sunday in March.
  776.  
  777.     Both DST and "Summer Time" end on the last Sunday in October.
  778.  
  779. IV. CONFIGURATION:
  780.  
  781.     The configuration of AEMail is provided by parameters presented as Tool
  782.     Types in the AEMail icon or by a Configuration screen that can be called
  783.     up from within AEMail using the "Project/Configuratio/Edit.." menu item.
  784.     All configuration items provided by Tool Types can also be provided by 
  785.     the Configuration screen  with the exception of the MAIL_DIR= and the 
  786.     CONFIG= Tool Types.  These two Tool Types have special uses, as explained
  787.      below, that can not be duplicated by the configuration screen.
  788.  
  789.     Certain configuration parameters can ONLY be provided by the Configuration 
  790.     screen.
  791.  
  792.     Currently, setting the time zone that you are in is done outside the AEMail
  793.     environment.  To set the time zone for AEMail see "HANDLING OF TIME ZONES
  794.     IN AEMAIL" above.
  795.  
  796.     If you are running AEMail from the shell or as a "mailto:" agent, it must
  797.     be either pre-configured (through the S:aemail.cnfg file), or you will
  798.     have to use the configuration screens for the configuration.  You can
  799.     specify an alternate configuration file (other than S:aemail.cnfg) by
  800.     using the config= parameter on the AEMail call line.
  801.  
  802.     The first thing AEMAIL does when it is activated is check to see that
  803.     certain configuration information has been provided either through Tool
  804.     Types or as contained in the AEMail configuration file.  The necessary
  805.     items are:
  806.  
  807.         POP3 UserID
  808.         Password
  809.         From Addr (your email address)
  810.         SMTP Domain Name
  811.         Edit Call
  812.  
  813.     If these items have not been provided, the following requester will be
  814.     immediately displayed:
  815.  
  816.         The following Configuration items are empty
  817.  
  818.         [list of empty items]
  819.  
  820.         They are required items!
  821.  
  822.     The Pop Server call and the SMTP call will also be included in this
  823.     list if the SMTP Domain Name was missing.
  824.  
  825.     Also, the Edit Call item, if it is missing, will default to:
  826.  
  827.         C:ed %s
  828.  
  829.     with the editor opening on the Workbench.  The only way the Edit Call
  830.     can appear in the list is if the Configuration screen had been entered
  831.     and the Edit call field cleared.
  832.  
  833.     If this requester is displayed, you will be given the following choices:
  834.  
  835.            [Configure AEMAIL now]               [Cancel AEMAIL]
  836.  
  837.     If you were to click on [Cancel AEMAIL], AEMAIL will terminate.  You can
  838.     not proceed any further until you have entered these items with the
  839.     Configuration screen or by providing them as Tool Types.
  840.  
  841.     Clicking on the [Configure AEMAIL now] will bring up the Configuration
  842.     screen which is described below following the description of the Tool
  843.     Types.
  844.  
  845.     Also, if "Mail Directory" appears in the list of empty items, it means 
  846.     that the AEMail: assign is not in the system and the MAIL_DIR Tool Type 
  847.     has not been given.  There is no way you can provide this information 
  848.     through the Configuration screen.  You will have to either provide the 
  849.     ASSIGN statement or add the MAIL_DIR Tool Type.  If you use the standard 
  850.     install script, this should never be necessary.
  851.  
  852.     The two Tool Types, MAIL_DIR= and CONFIG= have special uses.  CONFIG= is 
  853.     used to specify an alternate configuration file other than s:aemail.cnfg
  854.     that AEMail is to open with.  MAIL_DIR= is used to specify a mail directory
  855.     other than the one provided by the AEMAIL: assign.  It is used to 
  856.     provide an alternate location for the mail files.
  857.  
  858.     If you have two or more users of AEMail on the same system and you want 
  859.     each user to have different locations for their mail files, you can 
  860.     establish an alternate location for one of the mail files.  To do this, you
  861.     will have to have two different instances of the AEMail executable in
  862.     two different directories (or, if they are in the same directory, you
  863.     will have to rename one of the copies - in this case you might want to 
  864.     edit the icon so it shows something different).  You then must go into
  865.     the Tool Types (you can do this by selecting the icon and using the 
  866.     Workbench menu "Information").  Add (or change) the CONFIG= Tool Type
  867.     to reflect where the configuration file is for that particular user and
  868.     add (or change) the MAIL_DIR= Tool Type to give the full path name of the
  869.     mail directory for that user.  Be sure to include the ending '/' after 
  870.     the directory name.
  871.  
  872.     As an example, lets say you have two users named John and Jan.  You install
  873.     AEMail (using the expert mode) in a directory called HD1:AEMail/John and 
  874.     the AEMAIL: assign is set to:
  875.  
  876.         ASSIGN AEMAIL: HD1:AEMail/John/AEMail_Mail
  877.  
  878.     If you wanted your configuration file to be aemail.cnfg in the 
  879.     HD1:AWMail/John directory, you could add the following Tool Type to 
  880.     the AEMail icon in AEMail/John:
  881.  
  882.         CONFIG=HD1:AEMail/John/aemail.cnfg
  883.  
  884.     You could then create another directory in HD1:AEMail called Jan.  Then
  885.     copy the AEMail executable and its icon to the Jan directory and change
  886.     Jan's CONFIG= Tool Type to:
  887.  
  888.         CONFIG=HD1:AEMail/Jan/aemail.cnfg
  889.  
  890.     and add the MAIL_DIR= Tool Type as follows:
  891.  
  892.         MAIL_DIR=HD1:AEMail/Jan/AEMail_Mail/
  893.  
  894.     Then, when John wants to use his copy of AEMail and his files, he double
  895.     clicks on the AEMail icon in his drawer, and when Jan wants to use her copy
  896.     she double clicks on the one in her drawer.  The one restriction is that
  897.     you cannot have both copies of AEMail running at the same time.  Each set
  898.     will be set up with different configuration files so that information
  899.     in these files can be different.
  900.  
  901.     You can configure both instances of AEMail through either the Tool Types
  902.     in the appropriate icon or with the configuration screen when you execute
  903.     that particular instance of AEMail.
  904.  
  905.  
  906.     TOOL TYPES
  907.  
  908.         Tool Types have been provided to initially provide certain Configuration
  909.         information when AEMAIL is first activated without the need to build
  910.         the Configuration information through the Configuration screens.
  911.  
  912.         To modify or delete any specific Tool Type, select the AEMAIL icon and
  913.         then select the "Information" item from the workbench menu.  You will
  914.         have to select the appropiate Tool Type and modify it when it appears in
  915.         the string gadget below the Tool Type list.
  916.  
  917.         The current Tool Types utilized by the program are:
  918.  
  919.         INTERLACE=YES
  920.  
  921.             Opens the AEMail Public Screen (AEMAIL-1) in hires, interlace
  922.             mode.  If this tool type is omitted, the screen will be
  923.             opened as a hires, non-interlaced screen.
  924.  
  925.             You can actually have more control over the Screen Mode you
  926.             desire by selecting the "Set Screen Mode" button in the
  927.             AEMAIL Configuration: General Parameters configuration display.
  928.             Selecting a Screen Mode from the Configuration display precludes
  929.             the use of this Tool Type.
  930.  
  931.  
  932.         MAIL_DIR=directory-path
  933.  
  934.             If you do not place the AEMAIL ASSIGN statement in your
  935.             Startup-Sequence, you can use this Tool Type to assign your mail
  936.             directory.  This can also be used to provide an alternate location
  937.             to the AEMAIL Assign statement when you have more than one instance
  938.             of AEMail in your system.  This parameter CAN NOT be provided 
  939.             with the Configuration screen. (DEFAULTS TO AEMAIL: This assumes
  940.             that the AEMAIL ASSIGN is present).  If you are using a different
  941.             directory, be sure and include the ending '/' at the end of the
  942.             directory path.
  943.  
  944.         CONFIG=configuration-file
  945.  
  946.             If you do not care to use the standard s:aemail.cnfg file for
  947.             your configuration data, but want a file named something else 
  948.             or in a different location, you can use this tool type.  When 
  949.             AEMail opens it will look here for the configuration file.  
  950.             YOU MUST PRECEDE THE FILE NAME WITH THE FULL PATH NAME.  This 
  951.             parameter CAN NOT be provided with the Configuration screen, 
  952.             although the initial file can be created, saved, and edited 
  953.             from the "Project/Configuration" menu.  (DEFAULTS TO 
  954.             s:aemail.cnfg)
  955.  
  956.  
  957.         MAILCAP_DIR=directory-path
  958.  
  959.             Your mailcap file can reside in any directory you want.
  960.             Use this Tool Type to assign the mailcap directory path.
  961.             If this parameter is missing, the MAIL_DIR path will
  962.             be used as the mailcap directory path.
  963.  
  964.             The mailcap file must be called "mailcap".  Since the
  965.             mailcap file follows a standard format dictated by the
  966.             internet, you can use the same mailcap file used by
  967.             another process.  That is the purpose of this Tool Type.
  968.  
  969.             This parameter can also be provided with the Configuration
  970.             Screen (DEFAULTS TO AEMAIL:).
  971.  
  972.  
  973.         USERID=UserId
  974.  
  975.             Enter your POP3 UserId for signing onto your POP Server on
  976.             your Internet provider (ISP).  This may be the same as the
  977.             one initially used to sign into your ISP.  It is also very
  978.             possibly (but not always) the part of your email address
  979.             that precedes the @ sign.  Check with your ISP for what 
  980.             should be used.
  981.  
  982.             Example: my UserId is "jzachar" so I would enter
  983.  
  984.                 USERID=jzachar
  985.  
  986.             for this Tool Type.  THIS IS A REQUIRED PARAMETER, but it
  987.             can be provided with the Configuration Screen.
  988.  
  989.  
  990.         PASSWRD=your_password
  991.  
  992.             Enter the password required for signing onto your POP3 server.
  993.             This may or not be the same as that used to sign onto your
  994.             Internet provider.  THIS IS A REQUIRED PARAMETER, but it can 
  995.             be provided with the Configuration Screen.
  996.  
  997.             SPECIAL NOTE: if the password is provided by a Tool Type it can
  998.             be read by anyone that performs an "Information" on the AEMAIL
  999.             icon.  If you provide the password through the Configuration 
  1000.             screen, it can not be seen.
  1001.  
  1002.  
  1003.         DOMAIN=Domain_Name
  1004.  
  1005.             Enter the Domain name used by your Internet provider's SMTP 
  1006.             server. It very possibly is the same as the Domain part of
  1007.             your email address (the part following the @ sign) 
  1008.  
  1009.             Example: my Internet provider's domain name is "calweb.com" 
  1010.             so I would enter
  1011.  
  1012.                 DOMAIN=calweb.com
  1013.  
  1014.             for this Tool Type.  THIS IS A REQUIRED PARAMETER, but it
  1015.             can be provided with the Configuration Screen.
  1016.  
  1017.  
  1018.         FROM=your_email_address
  1019.  
  1020.             Enter your FULL email address (i.e. user@domain).  This is 
  1021.             email address that you are known by on the Internet.
  1022.  
  1023.             Example: my email address is "jzachar@calweb.com" so I would
  1024.             enter 
  1025.  
  1026.                 FROM=jzachar@calweb.com
  1027.  
  1028.             for this tool type.  THIS IS A REQUIRED PARAMETER, but it
  1029.             can be provided with the Configuration Screen.  If it is
  1030.             missing it defaults to UserID@Domain.  This default action
  1031.             may NOT be correct for your situation, so be sure to change
  1032.             it if required to.  
  1033.  
  1034.  
  1035.         REALNAME=your_real_name
  1036.  
  1037.             Enter your full name.  Example:
  1038.  
  1039.                 REALNAME=John Zacharias
  1040.  
  1041.             This is an OPTIONAL parameter, but if it is omitted your
  1042.             full name will NOT be provided in the FROM: address of any
  1043.             messages you send unless you add it yourself when you compose
  1044.             a message.  This parameter can also be provided with the
  1045.             Configuration Screen.
  1046.  
  1047.  
  1048.         REPLYTO=reply-email-address
  1049.  
  1050.             This is the email address that you want all replies directed 
  1051.             to.  This may be the same as your FROM email address or it
  1052.             can be a different address if you want replies sent somewhere
  1053.             else.  This is an OPTIONAL parameter and can also be provided
  1054.             with the Configuration screen.
  1055.  
  1056.             The standard REPLY-TO address provided here can also be 
  1057.             modified each time you compose a message to send.
  1058.  
  1059.  
  1060.         ORGANIZATION=organization-name
  1061.  
  1062.             This parameter is OPTIONAL and, if present, will provide
  1063.             an Organization: header for any message that you compose 
  1064.             and send.  This parameter can also be provided with the 
  1065.             Configuration screen.
  1066.  
  1067.  
  1068.         POP_SERVER=your_POP_host
  1069.  
  1070.             Enter the name of your POP host.  This sometimes is "pop."
  1071.             or "mail." prepended to your Domain name.  As an example, 
  1072.             mine is "pop.calweb.com" so I would enter
  1073.  
  1074.                 POP_SERVER=pop.calweb.com
  1075.  
  1076.             If this parameter is omitted, "pop.[domain]" will be generated
  1077.             as your POP_SERVER name provided a domain name has been specified.
  1078.             Unless your POP server is different it is recommended that you
  1079.             do not include this Tool Type.
  1080.  
  1081.             This parameter can also be provided by the Configuration Screen.
  1082.  
  1083.  
  1084.         SMTP_SERVER=your_SMTP_host
  1085.  
  1086.             Enter the name of your SMTP host.  This sometimes is "smtp."
  1087.             or "mail." prepended to your Domain name.  As an example, 
  1088.             mine is "smtp.calweb.com" so I would enter
  1089.  
  1090.                 SMTP_SERVER=smtp.calweb.com
  1091.  
  1092.             If this parameter is omitted, "smtp.[domain]" will be generated
  1093.             as your SMTP_SERVER name provided a domain name has been specified.
  1094.             Unless your SMTP server is different it is recommended that you
  1095.             do not include this Tool Type.
  1096.  
  1097.             This parameter can also be provided by the Configuration Screen.
  1098.  
  1099.  
  1100.         EDITOR=call_line_for_your_editor
  1101.  
  1102.             Enter the full call parameter required to activate your editor
  1103.             from the shell.  Use "%s" where you would place the file name.
  1104.  
  1105.             Your editor should be called so that it remains in control
  1106.             while AEMAIL is utilizing it.  If you are using CygnusEd (CED) 
  1107.             as your editor, that is not normally the case.  You can force
  1108.             CED to not relenquish control by one of two methods:
  1109.  
  1110.                 (1)  Use the CED activator program ED with the -sticky
  1111.                      option.  The CED activator ED has the same name as 
  1112.                      the AmigaDos ED, but is usually contained in the 
  1113.                      SYS/Utilities drawer rather than the C: drawer.  If
  1114.                      you use this method, do not call CED directly.  
  1115.                      "-sticky" will not work with a direct call to CED.
  1116.  
  1117.                      As an example the editor call using the CED activator
  1118.                      program would be:
  1119.  
  1120.                         EDITOR=Sys:Utilities/ED %s -sticky
  1121.  
  1122.                 (2)  You can call CED directly using the "-keepio" option.
  1123.                      However, if you do this, you will get an "out of stack"
  1124.                      error.  The way around this is to call CED from a 
  1125.                      script.  A script called "AEMced.scp" is provided
  1126.                      with AEMail for this purpose.  As written, the script
  1127.                      only works if CED is in the C: directory.  If it 
  1128.                      is somewhere else you will either have to add a CD
  1129.                      statement to change to that directory or place the
  1130.                      full path name in front of the CED call.  As an
  1131.                      example:  if CED is in SYS:Utilities, either the
  1132.                      following statement must be added before the CED
  1133.                      call:
  1134.  
  1135.                         CD SYS:Utilities
  1136.  
  1137.                      or the following added in front of the CED call:
  1138.  
  1139.                         SYS:Utilities/CED <name> -keepio
  1140.  
  1141.                     The editor call in AEMail would then read:
  1142.  
  1143.                         EDITOR=s:AEMced %s
  1144.  
  1145.                 If you use the accompanying AEMail install script at the 
  1146.                 Intermediate or above level, this script will be installed
  1147.                 and modified as necessary if you tell it you are using CED.
  1148.  
  1149.             If your editor opens on the workbench screen rather than a screen
  1150.             of its own, you should prepend "WB;" in front of your editor call.
  1151.             As an example, the standard AmigaDos ED program always opens on the
  1152.             workbench screen.  An example edit call for the Amiga ED would
  1153.             be as follows:
  1154.  
  1155.                 EDITOR=WB;c:ed %s WINDOW raw:0/0/640/400/AEMailCompose
  1156.  
  1157.             The window statement in the above call is used to create a full
  1158.             screen window with an interlaced display.
  1159.  
  1160.             If you are not using an interlaced display you can remove the
  1161.             WINDOW parameter or change it to raw:0/0/640/200/AEMailCompose.
  1162.             You can, of course, make other changes to the window parameters
  1163.             if you desire.
  1164.  
  1165.             If you are using the Amiga ED you should probably also remove or
  1166.             rename the ED-Startup file in the S: directory so that you will
  1167.             have a full set of ED menus.
  1168.  
  1169.             If this Tool Type is missing, the following call is the default
  1170.             editor call:
  1171.  
  1172.                 EDITOR=WB;c:ed %s
  1173.  
  1174.             The specification for your editor call can also be provided
  1175.             by the Configuration Screen.  A convenient check mark item is
  1176.             provided in the Configuration Screen to open the editor on the
  1177.             Workbench screen.
  1178.  
  1179.  
  1180.         TCPLOG=name_of_log_file
  1181.  
  1182.             Enter the full path of your TCP logging file.  If this parameter
  1183.             is omitted, it defaults to "tcplog" in the directory AEMail is 
  1184.             loaded from.
  1185.  
  1186.             This parameter does not start TCP logging, it only establishes
  1187.             the name of the TCPLOG file.  Logging can be started or stopped
  1188.             at any time by a menu item (see Section VII. AEMAIL MENUS - TCP
  1189.             Logging File under the TCP/IP menu).  The Logging file can be
  1190.             active when AEMail is started through a parameter in a
  1191.             Configuration Screen item.
  1192.  
  1193.             When TCP logging is active, all sends and receives over the TCP/IP
  1194.             connection are recorded to this file.  Each time an AEMAIL
  1195.             session is started and logging is active, data is appended to 
  1196.             this file.  As a result this file can become quite large.  IT IS 
  1197.             THE USER'S RESPONSIBILITY TO PERIODICALLY PURGE (DELETE) THIS 
  1198.             FILE.  A menu item is provided to perform this purge and another
  1199.             item to display the log file with your editor from within AEMail.
  1200.  
  1201.             NOTE:  When there is a need to report a problem, especially with
  1202.             your TCP/IP connection, the TCP Logging file should be set
  1203.             active and a copy of the resultant file provided with any feedback 
  1204.             on the program activity (see Section X, Bug Reports & Suggestions).
  1205.             The file can be sent as an attachment to any message that you send 
  1206.             to AEMAIL.  You probably should compress the file with LHA before 
  1207.             attaching it as an "Applicatio/Octet Stream" content type with
  1208.             "encoded binary" encoding.
  1209.  
  1210.             I have discovered that this file comes in handy when analysing
  1211.             problems with your Internet provider since it time stamps all
  1212.             entries to the nearest second.
  1213.  
  1214.             This parameter can also be provided by the Configuration Screen.
  1215.  
  1216.  
  1217.         DELETEMAIL=YES
  1218.  
  1219.             This Tool Type sets the initial value of the "Delete Host Mail"
  1220.             menu item under the RETRIEVE MSGS menu.  If this Tool Type is
  1221.             entered, the "Delete Host Mail" menu item will be initially checked.
  1222.             See the "Delete Host Mail" item under section VII. AEMAIL MENUS below.
  1223.  
  1224.             This parameter can also be set by the Configuration Screen or
  1225.             the DELETEMAIL flag can be set with a menu item and its state
  1226.             can be saved in the configuration file by selecting the 
  1227.             "PROJECT/CONFIGURATION/SAVE" menu item.
  1228.  
  1229.  
  1230.         FULLHEADER=YES
  1231.  
  1232.             This Tool Type sets the initial value of the "Display Full Hdr"
  1233.             menu item under the MESSAGES menu.  If this Tool Type is
  1234.             entered, the "Display Full Hdr" menu item will be initially checked.
  1235.             See the "Display Full Hdr" item under section VII. AEMAIL MENUS below.
  1236.  
  1237.             This parameter can also be set by the Configuration Screen or
  1238.             the FULLHEADER flag can be set with a menu item and its state
  1239.             can be saved in the configuration file by selecting the 
  1240.             "PROJECT/CONFIGURATION/SAVE" menu item.
  1241.  
  1242.  
  1243.         STRIPDUPS=YES
  1244.  
  1245.             This Tool Type sets the initial value of the "Excl Dup Msgs"
  1246.             menu item under the RETRIEVE MSGS menu.  If this Tool Type is
  1247.             entered, the "Excl Dup Msgs" menu item will be initially checked.
  1248.             See the "Excl Dup Msgs" item under section VII. AEMAIL MENUS below.
  1249.  
  1250.             This parameter can also be set by the Configuration Screen or
  1251.             the STRIPDUPS flag can be set with a menu item and its state
  1252.             can be saved in the configuration file by selecting the 
  1253.             "PROJECT/CONFIGURATION/SAVE" menu item.
  1254.  
  1255.  
  1256.         HDRINREPLY=YES
  1257.  
  1258.             This Tool Type sets the initial value of the "Incl Hdr in Resp"
  1259.             menu item under the MESSAGES menu.  If this Tool Type is
  1260.             entered, the "Incl Hdr in Resp" menu item will be initially checked.
  1261.             See the "Incl Hdr in Resp" item under section VII. AEMAIL MENUS below.
  1262.  
  1263.             This parameter can also be set by the Configuration Screen or
  1264.             the HDRINREPLY flag can be set with a menu item and its state
  1265.             can be saved in the configuration file by selecting the 
  1266.             "PROJECT/CONFIGURATION/SAVE" menu item.
  1267.  
  1268.  
  1269.         STARTNET=call_line_for_your_startnet_script
  1270.  
  1271.             This Tool Type is used to specify the call line for your script
  1272.             that starts up your TCP/IP stack.  If you are using AmiTCP, this
  1273.             is normally the file "startnet" in the AMITCP:bin directory.  If
  1274.             you are using Miami, an AREXX script has been provided with the
  1275.             AEMail archive called "startnet.miami" and it is located in the
  1276.             AEMail program directory.
  1277.  
  1278.             A full path name to that script must be entered.  If the script is
  1279.             an AREXX script it should be preceded with "rx " (a space is between
  1280.             the rx and the script name).  The standard AmiTCP startnet script
  1281.             is NOT an AREXX script even though it uses AREXX commands.  It
  1282.             is an AmigaDOS script.  The Miami script, on the other hand, is
  1283.             an AREXX script.
  1284.  
  1285.             If you do not use the STARTNET Tool Type, AEMail assumes that
  1286.             you do not have a script.  If you activate the "Start Net" item
  1287.             in the TCP/IP menu and you don't have a startnet script, AEMail's 
  1288.             action is to iconify and allow you to manually start your TCP/IP
  1289.             stack.  Connect using the method prescribed by your TCP/IP stack.
  1290.             When you un-iconify AEMail, AEMail will immediately check to see 
  1291.             if any mail is present on your POP server.
  1292.  
  1293.             If you are using a TCP/IP stack that can't use a script (such as
  1294.             TermiteTCP) or you have no script to make connection to your
  1295.             Internet provider, then this Tool Type should not be used.  Then
  1296.             if you select the StartNet menu item, the system will automatically 
  1297.             iconify AEMail and present the Workbench screen.
  1298.   
  1299.             Since AmiTCP Demo Version 4.0 puts up a requester on the workbench
  1300.             screen that must be responded to, AEMail will automatically switch
  1301.             to the Workbench screen before calling this script.  Although
  1302.             the Miami script does not require manual intervention, the default
  1303.             action is to also switch to the Workbench screen since this allows
  1304.             you to see the action of the dialer.  When the connection has been
  1305.             made using Miami, the screen will automatically switch back to 
  1306.             the AEMail screen.
  1307.  
  1308.             The Start Net script can also be set by the TCP/IP page of the
  1309.             Configuration Screen.  The Configuration screen will also allow 
  1310.             you to set whether or not the system switches to the Workbench 
  1311.             screen when the Start Net script is executed.
  1312.  
  1313.             Note: Check your startnet script to be sure that full path names
  1314.             are specified.  If you are using the standard AmiTCP startnet
  1315.             script, that script may not be executed from the Amitcp:bin 
  1316.             directory (unless AEMAIL is executed from there).  Therefor, you
  1317.             should verify that Amitcp:bin/ is prepended to all calls to functions
  1318.             within the AmiTCP/bin directory within the script.  Pay particular 
  1319.             attention to the "online" call - it should be AmiTCP:bin/online.  
  1320.             You will also have to move the AREXX commands (such as WaitForPort 
  1321.             and RX) to the C: directory.  The installation script will 
  1322.             automatically do this for you.
  1323.  
  1324.  
  1325.         STOPNET=call_line_for_your_stopnet_script
  1326.  
  1327.             This Tool Type is used to specify the call line for your script
  1328.             that terminates your TCP/IP connection.  If you are using AmiTCP, 
  1329.             this is normally the file "stopnet" in the AMITCP:bin directory.  
  1330.             If you are using Miami, an AREXX script has been provided with the
  1331.             AEMail archive called "stopnet.miami" and it is located in the
  1332.             AEMail program directory.
  1333.  
  1334.             A full path name to that script must be entered.  If the script is
  1335.             an AREXX script it should be preceded with "rx " (a space between
  1336.             the rx and the script name).  The standard AmiTCP startnet script
  1337.             is NOT an AREXX script even though it uses AREXX commands.  It
  1338.             is an AmigaDOS script.  The Miami script, on the other hand, is
  1339.             an AREXX script.
  1340.  
  1341.             If you do not use the STOPNET Tool Type, AEMail assumes that you
  1342.             you do not have a script.  If you activate the "Stop Net" item
  1343.             in the TCP/IP menu and you don't have a stopnet script, AEMail's 
  1344.             action is to iconify and allow you to manually stop your TCP/IP
  1345.             stack.  You can then disconnect using the method prescribed by 
  1346.             your TCP/IP stack.  When you un-iconify AEMail, AEMail will test
  1347.             to see if you are, in fact, disconnected.
  1348.  
  1349.             If you are using a TCP/IP stack that can't use a script (such as
  1350.             TermiteTCP) or you have no script to terminate your connection to 
  1351.             your Internet provider, then this Tool Type should not be used.  
  1352.             Then if you select the Stop Net menu item, the system will 
  1353.             automatically iconify AEMail and present the Workbench screen.
  1354.   
  1355.             The Stop Net script can also be set by the TCP/IP page of the 
  1356.             Configuration Screen.  The Configuration screen will also allow 
  1357.             you to set whether or not the system switches to the Workbench 
  1358.             screen when the Stop Net script is executed.  Since terminating 
  1359.             your connection with a script usually does not require any 
  1360.             visual interaction, the default action is to NOT switch to 
  1361.             the Workbench screen.
  1362.  
  1363.             Note: Check your stopnet script to be sure that full path names
  1364.             are specified.  If you are using the standard AmiTCP stopnet
  1365.             script, that script may not be executed from the Amitcp:bin 
  1366.             directory (unless AEMail is executed from there).  Therefor, you
  1367.             should verify that Amitcp:bin/ is prepended to all calls to 
  1368.             functions within the AmiCCP:bin directory within the script.  
  1369.             Pay particular attention to the "offline" call - it should
  1370.             be AmiTCP:bin/offline.  You will also have to move the AREXX commands
  1371.             (such as WaitForPort and RX) to the C: directory.  The installation
  1372.             script will automatically do this for you.
  1373.  
  1374.  
  1375.         AUTOCONNECT=YES
  1376.  
  1377.             When AEMail is first activated it attempts to determine if you 
  1378.             are connected to your Internet provider.  If you are not and 
  1379.             this Tool Type is present, AEMail will automatically run your 
  1380.             StartNet script.
  1381.  
  1382.             Before activating this Tool Type, you should check to see if AEMail
  1383.             can activate your TCP/IP stack properly using the StartNet menu 
  1384.             item.  If there are any problems with your StartNet activation 
  1385.             they will show up at this time rather than constantly every time 
  1386.             you try to activate AEMAIL.
  1387.  
  1388.             WARNING: You should not use this Tool Type if a StartNet script
  1389.             is not present for your TCP/IP stack.  You should activate your 
  1390.             TCP/IP stack manually before you start AEMail.
  1391.  
  1392.  
  1393.             This parameter can also be set by the Configuration Screen.
  1394.  
  1395.  
  1396.  
  1397.     CONFIGURATION SCREEN
  1398.  
  1399.         The Configuration screen is displayed on the Workbench when you
  1400.         click on the [Configure AEMAIL now] button or when you select the 
  1401.         "Project/Configuration/Edit" menu item.  The configuration screen 
  1402.         is divided into four pages with the page name shown with a button 
  1403.         at the top of the page area.  When you click on any one button
  1404.         that button will become highlighted and the appropriate page will
  1405.         be displayed.
  1406.  
  1407.         The four pages are:
  1408.  
  1409.             IDENTITY
  1410.             TCP/IP
  1411.             PATHS
  1412.             GENERAL
  1413.  
  1414.         At the bottom of the Configuration screen is a row of buttons as
  1415.         follows:
  1416.  
  1417.  
  1418.                                          [USE] [SAVE] [SAVE AS] [CANCEL]
  1419.  
  1420.  
  1421.         Clicking on any one of these buttons will perform the requested 
  1422.         action, regardless of which page you are on, and return you to 
  1423.         the main AEMAIL screen.
  1424.  
  1425.         If you want the configuration information to apply only to this
  1426.         AEMAIL session select [USE].  If you want to make the configuration
  1427.         permanent, select [SAVE].  This will cause a new configuration file 
  1428.         to be written and will also signal that the configuration file is 
  1429.         to take precedence over the Tool Types the next time AEMAIL is 
  1430.         loaded.
  1431.  
  1432.         Normally the configuration file is either s:aemail.cnfg or the
  1433.         file specified in the CONFIG= tool type.  However, if you opened
  1434.         another configuration file with the "Project/Configuration/Open..."
  1435.         menu item, that configuration file will be the current active one.
  1436.  
  1437.         The [SAVE AS] button does the same as [SAVE] except that a file
  1438.         requester will be displayed that will allow you to rename and place
  1439.         the configuration file anywhere you wish.  WARNING: when you use
  1440.         the [SAVE AS] button, AEMAIL assumes that that file is now your
  1441.         active configuration file and any saves occuring after that will 
  1442.         be to that file.  To return to the base configuration (either 
  1443.         s:aemail.cnfg or the CONFIG= file), use the "Project/Configuration
  1444.         /Reset" menu item.
  1445.  
  1446.         [CANCEL] will abort the operation without making any changes to the
  1447.         configuration information.
  1448.  
  1449.         The [USE], [SAVE], [SAVE AS] or [CANCEL] buttons are active no matter 
  1450.         which configuration page is currently active.  When the Configuration
  1451.         screen is first activated, the Identity page will be active.
  1452.  
  1453.         Before exiting from the Configuration Screen with [USE], [SAVE], or
  1454.         [SAVE AS] the required configuration parameters must be present.  
  1455.         If not, the following requester will be displayed:
  1456.  
  1457.             The following Configuration items are empty
  1458.  
  1459.             [list of empty items]
  1460.  
  1461.             They are required items!
  1462.  
  1463.         This is the same requester that is displayed when AEMAIL is started
  1464.         without these parameters being provided.  Your choices with this
  1465.         requester are:
  1466.  
  1467.             [Reenter Configuration Data]   [Cancel Configuration Request]
  1468.  
  1469.         Clicking on the [Cancel Configuraion Request] will act the same
  1470.         as if you clicked on [CANCEL] in the main configuration screen.
  1471.         In this event your "old" configuration data will still be active
  1472.         and if you did not have the required parameters in the first
  1473.         place, you will not be able to do anything but enter the data
  1474.         or exit from AEMAIL.
  1475.  
  1476.         The one exception to the "old" configuration remaining the same is
  1477.         with the .headers file.  This is always updated no matter which
  1478.         button is pressed.
  1479.  
  1480.  
  1481.         Identity Parameters
  1482.         -------------------
  1483.  
  1484.         The Identity page appears as follows:
  1485.  
  1486.         =========================================================================
  1487.         AEMAIL Configuration Screen
  1488.         -------------------------------------------------------------------------
  1489.  
  1490.         [ IDENTITY ]____________________________________________________________
  1491.         |                                                                       |
  1492.         |         POP3 UserID: [               ][CLR][DEFAULT] [CHANGE PASSWORD]|
  1493.         |                                                                       |
  1494.         |From (email) Address: [                                 ][CLR][DEFAULT]|
  1495.         |                                                                       |
  1496.         |    Reply To Address: [                                 ][CLR]{DEFAULT]|
  1497.         |                                                                       |
  1498.         |           Real Name: [                                 ][CLR][DEFAULT]|
  1499.         |                                                                       |
  1500.         |        Organization: [                                 ][CLR][DEFAULT]|
  1501.         |                                                                       |
  1502.         |          POP Server: [                                 ][CLR][DEFAULT]|
  1503.         |                                                                       |
  1504.         |         SMTP Server: [                                 ][CLR][DEFAULT]|
  1505.         |                                                                       |
  1506.         |    SMTP Domain Name: [                                 ][CLR][DEFAULT]|
  1507.         |_______________________________________________________________________|
  1508.  
  1509.                                                   [USE] [SAVE] [SAVE AS] [CANCEL]
  1510.  
  1511.  
  1512.         =========================================================================
  1513.  
  1514.         When this page is first called up, values from the Tool Types or the
  1515.         current configuration file (which ever takes precedence) will be 
  1516.         displayed in each of the string gadgets.
  1517.  
  1518.         Appropriate information can be entered into each of the string gadgets.
  1519.  
  1520.         The buttons to the side of each string gadget perform the following
  1521.         actions:
  1522.  
  1523.             [CLR] will cause the string gadget to be cleared.
  1524.  
  1525.             [DEFAULT] will cause default information to be loaded into the
  1526.                 string gadgets as follows:
  1527.  
  1528.                     POP3 UserID: information from the USERID= Tool Type.
  1529.                     From Address: information from the FROM= Tool Type.
  1530.                     Reply To Address: information from the REPLYTO=
  1531.                         Tool Type or, if missing, the From Address. 
  1532.                     Real Name: information from the REALNAME= Tool Type.
  1533.                     Organization: information from the ORGANIZATION= Tool
  1534.                         Type.
  1535.                     SMTP Domain Name: Information from the DOMAIN= Tool Type.
  1536.                     POP Server: information from the POP_SERVER= Tool Type
  1537.                         if present; otherwise , if a Domain Name is present, 
  1538.                         this will be the domain name with 'pop.' prepended 
  1539.                         to it.
  1540.                     SMTP Server:  Information from the SMTP_SERVER= Tool
  1541.                         Type if present; otherwise, if a Domain Name is 
  1542.                         present, this will be the domain name with 'smtp.' 
  1543.                         prepended to it.
  1544.  
  1545.                 If a Tool Type was the only default and it is missing, 
  1546.                 nothing is loaded into the corresponding string gadget.
  1547.  
  1548.         The [CHANGE PASSWORD] button gadget will bring up a special window
  1549.         which will allow you to add or change your password.  This window looks
  1550.         like the follwing:
  1551.  
  1552.                     |========================================|
  1553.                     |0|Enter Password                        |
  1554.                     |----------------------------------------|
  1555.                     |                                        |
  1556.                     |     Enter your new password below      |
  1557.                     |                                        |
  1558.                     |  [                                  ]  |
  1559.                     |                                        |
  1560.                     |                                        |
  1561.                     |                                        |
  1562.                     |  [START OVER]            [  CANCEL  ]  |
  1563.                     |________________________________________|
  1564.  
  1565.  
  1566.         The string gadget will be automatically activated when the window
  1567.         is displayed.  You can type in your new password, but for each
  1568.         character you type, an '*' will appear.  After hitting return,
  1569.         the heading "Enter your password below" will be replaced by the
  1570.         following heading: "For verification, re-enter your password".
  1571.         You must re-enter your password and, when you hit return, if the
  1572.         re-entered password matches the first password, the password
  1573.         window will close.  The new password will not take effect until you
  1574.         hit the [USE], [SAVE] or [SAVE TO] buttons at the bottom of the 
  1575.         Configuration screen.  If you hit the [CANCEL] button at the
  1576.         bottom of the Configuration screen even though the new password
  1577.         has been accepted, the new password will not be used.
  1578.  
  1579.         If the re-entered password does not match, the following will
  1580.         appear below the password entry string gadget:
  1581.  
  1582.                 Password failed Validation!
  1583.  
  1584.         and the "Enter your password below" heading will re-appear.
  1585.  
  1586.         If at any time you want to start over with entering the new password,
  1587.         you can click on the [START OVER] gadget.  If you want to cancel
  1588.         the password entry process you can either click on the close gadget
  1589.         at the top left of the window or on the [CANCEL] gadget in the window.
  1590.  
  1591.  
  1592.         TCP/IP Parameters
  1593.         -----------------
  1594.  
  1595.         The TCP/IP page appears as follows:
  1596.  
  1597.         =========================================================================
  1598.         AEMAIL Configuration Screen
  1599.         -------------------------------------------------------------------------
  1600.  
  1601.         ____________[  TCP/IP  ]________________________________________________
  1602.        |                                                                        |
  1603.        |Start Net Call: [                                   ][REQ][CLR][DEFAULT]|
  1604.        |                [ ] Start Net Opens on the Workbench                    |
  1605.        |                                                                        |
  1606.        | Stop Net Call: [                                   ][REQ][CLR][DEFAULT]|
  1607.        |                [ ] Stop Net Opens on the Workbench                     |
  1608.        |                                                                        |
  1609.        | [ ] Automatic connection to Internet Provider on AEMAIL Start Up       |
  1610.        | [ ] Display disconnect check on AEMAIL exit                            |
  1611.        |                                                                        |
  1612.        |Disable Queued Mail Chk [] on connection establishment [] at AEMAIL exit|
  1613.        |   Disable New Mail Chk [] on connection establishment [] at AEMAIL exit|
  1614.        |                                                                        |
  1615.        |                  Check for new mail every [  ] minutes                 |
  1616.        |________________________________________________________________________|
  1617.  
  1618.                                                   [USE] [SAVE] [SAVE AS] [CANCEL]
  1619.  
  1620.  
  1621.         =========================================================================
  1622.  
  1623.         The "Start Net Call" and "Stop Net Call" are required if you are
  1624.         going to start up or stop your TCP/IP connection from within AEMail 
  1625.         with a script.  If you are using AmiTCP, this is normally either the 
  1626.         file "startnet" or "stopnet" in the AMITCP:bin directory.  If you are 
  1627.         using Miami, two AREXX scripts, called "startnet.miami" and 
  1628.         "stopnet.miami" have been provided with the AEMail archive located 
  1629.         in the AEMail program directory.
  1630.  
  1631.         When first presented, these two string gadgets will contain the 
  1632.         values given in you STARTNET and STOPNET Tool Types or what was 
  1633.         last stored in your configuration file.  If these two Tool types 
  1634.         are not present, these two string gadgets will be blank unless a 
  1635.         previous configuration file is present and has these calls.
  1636.  
  1637.         If you do not want what is presented as the default in these two
  1638.         string gadgets, you can enter the correct path and script name in 
  1639.         the string gadgets.  A full path name to that script must be 
  1640.         entered.  If the script is an AREXX script it should be preceded 
  1641.         with "rx " (a space is between the rx and the script name).  The 
  1642.         standard AmiTCP startnet script is NOT an AREXX script even though 
  1643.         it uses AREXX commands.  It is an AmigaDOS script.  The Miami script
  1644.         which comes with AEMail, on the other hand, is an AREXX script.
  1645.  
  1646.         The [REQ] button will call up a file requester to allow you the find 
  1647.         the script you want and [CLR] will clear the string gadget.  
  1648.  
  1649.         [DEFAULT] will place the script path and name from your Tool Types 
  1650.         in the appropriate string gadget.
  1651.  
  1652.         If you need the "Start Net" script or the "Stop Net" script to open on
  1653.         the workbench screen, click on the approriate check mark gadget for
  1654.         the particular script.  When the TCP/IP Configuration page first
  1655.         opens the "Start Net Opens on the Workbench" item will be checkmarked.
  1656.  
  1657.         SPECIAL NOTE FOR USERS OF TERMITE TCP:
  1658.  
  1659.         If you are using a TCP/IP stack that does not have a Start Net or
  1660.         Stop Net script (such as TermiteTCP), you should use the [CLR]
  1661.         button to clear these two string gadgets.  Starting and stopping
  1662.         your Internet connection is then done manually.  Then when you use 
  1663.         the Start Net or Stop Net menu item, the action that is performed
  1664.         is to iconify AEMail.  You can then perform the network connection
  1665.         in what ever manner was provided by your TCP/IP stack software.
  1666.         Once the connection is made, un-iconify AEMail and AEMail will then
  1667.         check your POP Server for any available messages if that option
  1668.         was selected (see below).
  1669.  
  1670.         The "Automatic connection to Internet Provider on AEMAIL Start Up"
  1671.         check box provides the same capability as the AUTOCONNECT Tool Type.
  1672.         When AEMail is first activated it attempts to determine if you are 
  1673.         connected to your Internet provider.  If you are not and this item 
  1674.         is checked, AEMail will automatically run your StartNet script.  
  1675.         However, the AUTOCONNECT function will be disabled if you do not 
  1676.         have a "Start Net" script.
  1677.  
  1678.         Except when you are using AEMail as a mailto: agent, when AEMail
  1679.         terminates and you are still connected to your Internet provider,
  1680.         the following Requester will be displayed:
  1681.  
  1682.                 Do you wish to terminate your Host connection now?
  1683.  
  1684.         You will given the opportunity to reply with either a [YES] or [NO].
  1685.         If you never want you Internet connection to be terminated when
  1686.         you exit from AEMAIL, you can prevent the above requester from being
  1687.         displayed by NOT checking the "Display disconnect check on AEMAIL
  1688.         exit" box.  By default, this box WILL BE CHECKED, so, to disable
  1689.         the function, you would have to click in this box.  However, this
  1690.         function will automatically be disabled if you do not have a
  1691.         Stop Net script.
  1692.  
  1693.         Please Note:  The way AEMail determines if you are still connected
  1694.         is to check if the "bdsocket.library" is present.  This library 
  1695.         may become present when you load your TCP/IP stack software.  Even 
  1696.         though you may not be connected the bdsocket.library will then be 
  1697.         present, so you will get the above notification even though you 
  1698.         are not actually connected.  In this event replying with either 
  1699.         [YES] or [NO] to the requester will have no effect. 
  1700.  
  1701.         Whenever AEMAIL is first loaded and is connected to Internet
  1702.         Provider or if you select "Start Net" from the "TCP/IP" menu,
  1703.         a check will be made for any mail on your POP server or any mail
  1704.         that must be sent from your QUEUED folder.  Except when you are
  1705.         using AEMail as a "mailto:" agent, this same check is also performed
  1706.         when you quit AEMAIL.  You can disable any of these checks by
  1707.         checking the appropriate box in the following lines:
  1708.  
  1709.         Disable Queued Mail Chk [] on connection establishment [] at AEMAIL exit
  1710.         Disable New Mail Chk [] on connection establishment [] at AEMAIL exit
  1711.  
  1712.         AEMAIL also has the capability for checking for mail periodically on
  1713.         your POP server.  This function is performed in the background so
  1714.         you can be doing other activities while this check is going on.
  1715.         When mail is found, the following requester will pop up on your screen:
  1716.  
  1717.  
  1718.                               YOU HAVE MAIL!!
  1719.  
  1720.                   n Messages available on the POP Server
  1721.  
  1722.                 Do you wish to receive these messages now?
  1723.  
  1724.  
  1725.         Replying [YES] to the above requester will start the retrieval of the
  1726.         messages.  If you are in iconify mode when this occurs, the retrieval
  1727.         will occur in the background without bringing up the AEMail screen.
  1728.  
  1729.         You can set the time interval for this check by entering the 
  1730.         appropriate number of minutes in the following numeric gadget:
  1731.  
  1732.                       Check for new mail every [  ] minutes
  1733.  
  1734.         The default time interval is 2 minutes.  If you enter a zero in
  1735.         this numeric gadget, no check will be made.
  1736.  
  1737.  
  1738.         Default Path Parameters
  1739.         -----------------------
  1740.  
  1741.  
  1742.         The Default Path page appears as follows:
  1743.  
  1744.         =========================================================================
  1745.         AEMAIL Configuration Screen
  1746.         -------------------------------------------------------------------------
  1747.  
  1748.         ________________________[  PATHS  ]_____________________________________  
  1749.        |                                                                        |
  1750.        |             Mailcap Directory: [                   ][REQ][CLR][DEFAULT]|
  1751.        |                                                                        |
  1752.        |              TCP Logging File: [                   ][REQ][CLR][DEFAULT]|
  1753.        |                                [ ] TCP Logging Active on AEMAIL startup|
  1754.        |                                                                        |
  1755.        |  Retrieve Mail from Directory: [                   ][REQ][CLR][DEFAULT]|
  1756.        |                                                                        |
  1757.        |        Save Mail to Directory: [                   ][REQ][CLR][DEFAULT]|
  1758.        |                                                                        |
  1759.        |Add Attachments from Directory: [                   ][REQ][CLR][DEFAULT]|
  1760.        |                                                                        |
  1761.        | Save Attachments to Directory: [                   ][REQ][CLR][DEFAULT]|
  1762.        |________________________________________________________________________|
  1763.  
  1764.                                                   [USE] [SAVE] [SAVE AS] [CANCEL]
  1765.  
  1766.  
  1767.         =========================================================================
  1768.  
  1769.         String gadgets are provided for giving the full path for each of
  1770.         the default directories and or file.  The directory paths that can
  1771.         be specified are:
  1772.  
  1773.             Mailcap Directory: This is the directory that contains your
  1774.                 mailcap file.  The file will always be named "mailcap".
  1775.                 The default entry for this is "AEMAIL:".
  1776.  
  1777.             TCP Logging File:  This allows you to enter a file name as well
  1778.                 as a path.  The default path and file name is "tcplog" in
  1779.                 the AEMail program directory.  If this field is cleared, no 
  1780.                 TCP logging can take place.  When the [SAVE], [SAVE AS] or 
  1781.                 [USE] gadgets are selected, if TCP Logging was active and 
  1782.                 the TCP logging File name that was entered is different
  1783.                 from the current log file, the current log file will be
  1784.                 closed and a new file opened.  If you clear this field
  1785.                 TCP logging will stop since there is no file to log to.
  1786.  
  1787.                 Whether logging takes place or not should depend on the
  1788.                 "TCP/IP/TCP Logging File/Active" menu item (checkmarked
  1789.                 flag).
  1790.  
  1791.                 You can cause TCP logging to be active when AEMail starts
  1792.                 up by checking the "TCP Logging Active on AEMAIL startup"
  1793.                 check mark gadget below the TCP Logging File string gadget.
  1794.                 If this item is checked, the logging will become active 
  1795.                 when you exit from the Configuration screen.  You will have
  1796.                 to turn off the Active flag in the "TCP/IP/TCP Logging File"
  1797.                 menu item to stop logging.
  1798.  
  1799.                 Note: none of the actions mentioned above will take place 
  1800.                 until you select [USE], [SAVE] or [SAVE TO] at the bottom
  1801.                 of the Configuration screen.  If you select [CANCEL] no 
  1802.                 change will be made in your TCP logging activity.
  1803.  
  1804.             Retrieve Mail from Directory:  This is the initial path that will
  1805.                 appear in the file requester when you Retrieve mail from a
  1806.                 file rather than your POP Server.  The default directory for
  1807.                 these files is "PROGDIR:" which is your current AEMail program
  1808.                 directory.  If you regularly are trying to bring in mail that
  1809.                 was previously transferred using another mail user agent such 
  1810.                 as AmiPOP, AirMail, or Voodoo, you should use the directory
  1811.                 that was used for these agents for storing mail.  You can 
  1812.                 specify any directory of your choosing as the default path 
  1813.                 for the Retrieve Mail file requester.  You enter that
  1814.                 default in this string gadget.
  1815.  
  1816.             Save Mail to Directory:  This is the initial path that will appear
  1817.                 in the file requester when you select the "Save Mail" icon
  1818.                 in the command icon strip.  The default directory for this
  1819.                 path is PROGDIR:, which is your current program directory.
  1820.                 However, you can specify any other path of your choosing as
  1821.                 the default path for the Save Mail file requester.  You enter
  1822.                 that default in this string gadget.
  1823.  
  1824.             Add Attachments from Directory:  This is the initial path that will
  1825.                 appear in the file requester when you select the [REQ] button
  1826.                 in the Add Attachment requester (see below under Section VIII.
  1827.                 AEMAIL WINDOWS.  The default directory for this path is PROGDIR:.
  1828.                 However, you can specify any other path of your choosing as
  1829.                 the default path for the Add Attachment requester.  You enter
  1830.                 that default in this string gadget.
  1831.  
  1832.             Save Attachments to Directory:  This is the initial path that will
  1833.                 appear in the file requester when you select the [Save] or
  1834.                 [View & Save] buttons in the Attachment requester (see below
  1835.                 under Section VIII. AEMAIL WINDOW.  The default directory for
  1836.                 this path is RAM:.  However, you can specify any other path of
  1837.                 your choosing as the default path for the Attachment file
  1838.                 requester.  You enter that default in this string gadget.
  1839.  
  1840.         When this this page is first activated, the values that were last saved
  1841.         in the current configuration file will be displayed.
  1842.  
  1843.         The buttons to the side of each string gadget perform the following
  1844.         actions:
  1845.  
  1846.             [CLR] will cause the string gadget to be cleared.
  1847.  
  1848.             [DEFAULT] will cause default information, as described above, to be
  1849.                 loaded into the appropriate string gadget.
  1850.  
  1851.             [REQ] causes a file requester to appear for selecting the appropriate
  1852.                 directory and file name (TCP Logging File only) to be loaded
  1853.                 into the appropriate string gadget.  The file requester will
  1854.                 start out with the last path that was used for that particular
  1855.                 string gadget.  If no path was last used, a dummy name of
  1856.                 "VOLUMES" will be used, the requester will flash, and the
  1857.                 volumes and assigns will be displayed.
  1858.  
  1859.  
  1860.  
  1861.         General Parameters
  1862.         ------------------
  1863.  
  1864.  
  1865.         The General Parameters page appears as follows:
  1866.  
  1867.         =========================================================================
  1868.         AEMAIL Configuration Screen
  1869.         -------------------------------------------------------------------------
  1870.  
  1871.         ___________________________________[ GENERAL ]__________________________  
  1872.        |                                                                        |
  1873.        |Printer Device: [PRT:            ][REQ][CLR][DEFAULT]   Top Margin:[4  ]|
  1874.        |                [ ] Include Attachment List in Print Out                |
  1875.        |                                                                        |
  1876.        |       [ Printer Setup ]                           [Set Screen Mode]    |
  1877.        |                           [Set Minimum Headers]                        |
  1878.        |                                                                        |
  1879.        |           [ ] Delete Mail from Server     [ ] Display Full Header      |
  1880.        |           [ ] Strip Duplicate Messages    [ ] Include Header in Reply  |
  1881.        |                                                                        |
  1882.        |     EditCall: [                                 ][REQ][CLR][DEFAULT]   |
  1883.        |               [ ] Editor Opens on the Workbench                        |
  1884.        |                                                                        |
  1885.        |                   Default Reply to Message Parameters                  |
  1886.        |                                                                        |
  1887.        |           [ ] Quote Original Message Text   Quote Prefix[>         ]   |
  1888.        |                                                                        |
  1889.        |           Quote Header: [                                          ]   |
  1890.        |________________________________________________________________________|
  1891.  
  1892.                                                   [USE] [SAVE] [SAVE AS] [CANCEL]
  1893.  
  1894.  
  1895.         =========================================================================
  1896.  
  1897.         The General Parameter page allows you to set up certain general type 
  1898.         parameters such as specifications for your printer device, your
  1899.         screen mode that you want your AEMail screen to open on, the list
  1900.         of minimum headers you want displayed in a message, certain default
  1901.         menu checkmarked items, the specification for your editor, and the 
  1902.         specifications for the default message reply headers.
  1903.  
  1904.         For the Printer Device you can specify the device that you want to
  1905.         do your printing on.  By default this is PRT:, but you can specify
  1906.         a file if you care to.  If you specify a file, your printer output
  1907.         will be sent as standard ASCII text with form feeds and margin
  1908.         spacing included in the output.  The [REQ] button will call up a
  1909.         file requester through which you can enter the path and file name
  1910.         of this printer file.  [CLR] will clear the string gadget and DEFAULT
  1911.         will enter PRT: into the gadget.  When this page is first displayed,
  1912.         the PRT: default will be in the gadget.
  1913.  
  1914.         You can also specify the Top Margin with the numeric string gadget
  1915.         to the right of the Printer Device.  The default top margin is 4.
  1916.  
  1917.         If you want the list of attachments to appear on the last page of
  1918.         your printout, you can check the "Include Attachment List in Print Out"
  1919.         box.  By default, this box is checked when you first call up the
  1920.         General Parameter screen.
  1921.  
  1922.         If you want to modify your printer setup parameters that are normally
  1923.         set with your PRINTER PREFERENCES, you can click on the [Printer Setup]
  1924.         button.  This will call up the Printer Preferences program so that
  1925.         you can can change your printer setup.  Please Note that, if you change
  1926.         the printer preferences, the new preferences will remain in effect when
  1927.         you quit AEMail.
  1928.  
  1929.         If you want to set your screen mode for AEMail, you can click on the
  1930.         [Set Screen Mode] button.  This will call up a Screen Mode Requester
  1931.         which will allow you to set whatever screen mode you wish.  Your
  1932.         overscan mode can also be set.  This defaults to "OVERSCAN-TEXT".
  1933.         When you save your configuration settings, the screen mode you
  1934.         selected and the overscan setting are saved in the AEMail 
  1935.         configuration file and will be used the next time you load AEMail.
  1936.  
  1937.         The minimum header set that you want displayed in your message
  1938.         can be set by clicking on the [Set Minimum Headers] button.
  1939.         This will bring up a requester that looks like this:
  1940.  
  1941.                      |==================================|
  1942.                      |[o]  Set Minimum Headers          |
  1943.                      |==================================|
  1944.                      |      Select/Deselect Headers     |
  1945.                      |          to be displayed         |
  1946.                      |==================================|
  1947.                      || *bcc:                        | ||
  1948.                      || *cc:                         | ||
  1949.                      ||  Content-Transfer-Encoding:  | ||
  1950.                      ||  Content-Type:               | ||
  1951.                      || *Date:                       | ||
  1952.                      || *From:                       | ||
  1953.                      |==================================|
  1954.                      |         Enter New Header         |
  1955.                      |[                                ]|
  1956.                      |                                  |
  1957.                      |              [OK]                |
  1958.                      |==================================|
  1959.  
  1960.         A list of possible message headers is displayed in the scrollable
  1961.         list.  An asterick (*) in front of a header indicates that it has
  1962.         been selected for inclusion in the minimum header list.  Clicking
  1963.         on an item in the list will select it with an (*).  If it is already
  1964.         selected, it will deselected (the asterick will change to a blank).
  1965.  
  1966.         The string gadget at the bottom of the requester is used to enter
  1967.         a header that is not in the list.  Be sure and end the header with
  1968.         a colon (:).  After entering the header, press return and the header
  1969.         will be place properly in the scollable list.  It will be deselected
  1970.         when it is first entered in the list.  You will have to click on it
  1971.         to select it.
  1972.  
  1973.         When you are through entering items in the list, click on [OK] and
  1974.         you will be returned to the General Parameters page.  Clicking on
  1975.         the close gadget at to top of the requester has the same effect as
  1976.         clicking on [OK].
  1977.  
  1978.         Please NOTE: anything you enter in the list or select/deselect will
  1979.         remain in the list in that state during the current run of AEMail
  1980.         even if you click on [CANCEL] in the main configuration window.  In
  1981.         other words, [CANCEL] for the minimum header list has the same
  1982.         effect as [USE].  Clicking on [SAVE] or [SAVE AS] at the bottom of 
  1983.         the screen will permanently save the headers you have selected.
  1984.  
  1985.         There is no way to delete a header once it has been entered in the
  1986.         list and saved except by deleting the .headers file in the AEMAIL:
  1987.         directory.  This is really not a problem, however, since, if you
  1988.         entered an incorrect header and haven't selected it, it will have no
  1989.         effect on the program.
  1990.  
  1991.         The four check boxes:
  1992.  
  1993.             [ ] Delete Mail from Server
  1994.             [ ] Display Full Header
  1995.             [ ] Strip Duplicate Messages
  1996.             [ ] Include Header in Reply
  1997.  
  1998.         have the same effect as the Tool Types DELETEMAIL=, FULLHEADER=,
  1999.         STRIPDUPS=, and HDRINREPLY=.  A checked condition is the same as
  2000.         a YES.  When you exit from the Configuration screen with [USE],
  2001.         [SAVE] or [SAVE AS], the corresponding menu items will be checked
  2002.         or unchecked depending on the state of these check boxes.
  2003.  
  2004.         For the EditCall string gadget you must use the full path name of
  2005.         the editor of your choice plus any parameters you want to use on 
  2006.         the call. To specify where the file name you are editing goes use 
  2007.         '%s'.  An example would be:
  2008.  
  2009.             c:ed %s
  2010.  
  2011.         Below the EditCall: string gadget is a checkmark gadget which is used
  2012.         to tell AEMail that your editor will open on the Workbench screen.  If
  2013.         your editor of choice does not open on it's own screen, you must check
  2014.         this item.  The AmigaDos editor, ED, does NOT open on it's own screen;
  2015.         therefor you must check this item if you are using ED.
  2016.  
  2017.         For special considerations in using CygnusED (CED) please see the
  2018.         discussion under the Tool Type EDITOR=.  If you plan on using CED
  2019.         you must take these considerations seriously or CED will not work
  2020.         in all instances.
  2021.  
  2022.         The DEFAULT for the EditCall is the information from the EDITOR 
  2023.         Tool Type.  If the key word 'WB;' precedes the editor call information
  2024.         in the tool type, the "Editor Opens on Workbench" item will be 
  2025.         checkmarked.  'WB;' will NOT appear in the EditCall string gadget.
  2026.  
  2027.         If the EDITOR Tool Type was not provided, the following will be the 
  2028.         default EditCall:
  2029.  
  2030.             c:ed %s
  2031.  
  2032.         and the "Editor Opens on Workbench" item will be checkmarked.  This
  2033.         uses the default AmigaDos editor, ed.
  2034.  
  2035.         If you need to find where your editor is located, [REQ] causes a file 
  2036.         requester to appear for selecting the appropriater program file to be 
  2037.         loaded into the EditCall string gadget.
  2038.  
  2039.  
  2040.         The section below the heading "Default Reply to Message Parameters"
  2041.         is used to set up the default actions when you are replying to a
  2042.         message.  The "Quote Original Message Text" box sets up the default
  2043.         action for quoting the original text in a message.  Even though
  2044.         you take the default of not quoting text, you will be given an 
  2045.         opportunity to change you mind about this when you compose the 
  2046.         message.
  2047.  
  2048.         The "Quote Prefix:" string gadget indicates what is to be placed in
  2049.         front of each quoted line if an original message is quoted.  This, by
  2050.         default, is '>'; however, you can use any other prefix as the derfault
  2051.         that you like.
  2052.  
  2053.         A "Quote header:" will be placed on the line in front of the quoted
  2054.         material.  You can choose what you would like as the default heading
  2055.         and enter it in this string gadget.  By default, the header which will
  2056.         initially appear in the "Quote Header:" string gadget is:
  2057.  
  2058.             On &(week), &(date2), at &(time), &(name) wrote:
  2059.  
  2060.         The & followed by a field name in parenthesis indicates substitution
  2061.         of data from the original message.  The values that can be
  2062.         substituted are:
  2063.  
  2064.             &(name)     The real name of the sender of the original
  2065.                         message.  If the real name is not available,
  2066.                         the sender's email address will be used instead
  2067.  
  2068.             &(subject)  The subject from the original message.  Any RE:
  2069.                         or (fwd) will be stripped.
  2070.  
  2071.             &(week)     The day of the week that the original message
  2072.                         was sent.
  2073.  
  2074.             &(date)     The date the original message was sent in the form
  2075.                         DD MMM YYYY, where DD is the day of the month,
  2076.                         MMM is month in the form Jan, Feb, Mar, etc, and
  2077.                         YYYY is the full 4 digit year.
  2078.  
  2079.             &(date1)    Same as &(date).
  2080.  
  2081.             &(date2)    The date in the form MMM DD, YYYY.
  2082.  
  2083.             &(time)     The time the original message was sent in the
  2084.                         form HH:MM xM where HH is the hour on a 12 hour
  2085.                         clock, MM is the minute, and xM is AM or PM.
  2086.  
  2087.         The "Quote Header" is designed to be modified by the user and
  2088.         can be changed with this string gadget.  This is a permanent change
  2089.         if you save the Configuration data or it can be in effect as the
  2090.         default for only this running of AEMail if you select [USE].  You can
  2091.         always change this default, however, when you compose a message.
  2092.  
  2093. V. STARTING AEMAIL
  2094.  
  2095. Starting AEMail
  2096.  
  2097.     AEMail can be started either from the Workbench by double clicking on
  2098.     it's icon or from the shell.  It is recommended that AEMail be normally
  2099.     run from the Workbench.  The shell invocation is primarily designed for
  2100.     "MailTo" agents in WWW browsers.  When invoked from the shell, there are
  2101.     three optional argument that can be used as follows:
  2102.  
  2103.         AEMail [email-addr-of-recipient-of-email] [config=configuration_file]
  2104.             [pubscr=browser-screen-name]
  2105.  
  2106.     If the recipient's email address is present, AEMail assumes that we are 
  2107.     using AEMail as a "MailTo" agent.  AEMail will load and immediately 
  2108.     display the Compose message window.  After you have composed the message
  2109.     a requester will be displayed which asks:
  2110.  
  2111.                     What action do you wish to perform
  2112.                      on the message you just created?
  2113.  
  2114.     You are given the following options:
  2115.  
  2116.                 [SEND NOW]   [QUEUE]   [CANCEL]   [NO ACTION]
  2117.  
  2118.     [SEND NOW] will immediately send the message; [QUEUE] will queue the
  2119.     message for later delivery; [CANCEL] will delete the message without
  2120.     sending it; and [NO ACTION] will leave the message in the Pending
  2121.     folder without any action being performed.  [SEND NOW], [QUEUE], and
  2122.     [CANCEL] work similarly to the corresponding commands described under
  2123.     Section VI. COMMAND ICON STRIP ([CANCEL] is the same as the DELETE
  2124.     command).
  2125.  
  2126.     Once the action requested is performed, AEMail will terminate.
  2127.  
  2128.     The "config=" keyword parameter is used to specify a configuration
  2129.     file other that the normal s:aemail.cnfg file.  All pertanent data
  2130.     on the AEMail configuration to be used will be in this file.  If
  2131.     you wish to invoke AEMail from the shell and have it run normally
  2132.     (not as a "MailTo" agent), you can use the "config=" parameter to
  2133.     direct AEMail to use a different configuration file on startup.  To
  2134.     use aemail in this manner, you could simply type:
  2135.  
  2136.         AEMAIL config=[name_of_configuration_file]
  2137.  
  2138.     If AEMail is used as a "mailto:" agent for your browser and that
  2139.     browser passes it's public screen name along with the userid, you
  2140.     can use the keyword argument "pubscn=" to specify that public screen.
  2141.     AEMail will then bring the browser's screen to the front when AEMail
  2142.     terminates.  If this argument is missing and the browser opens on it's
  2143.     own screen but does not, itself, bring the screen to the front when
  2144.     it returns from the "mailto" command, you might have to manually bring
  2145.     the browser's screen to the front with the LEFT-AMIGA M key.
  2146.  
  2147.     When you invoke AEMail from the shell with a email address parameter, you
  2148.     will not be able to use any of the AEMail menus or commands.  However,
  2149.     AEMail will check for Mail on your POP Server and for Queued messages
  2150.     before displaying the Compose message screen (see initial AEMAIL action
  2151.     below) and ask for configuration data if required parameters are not
  2152.     present in the s:aemail.cnfg file or the config= configuration file.
  2153.  
  2154.     If you invoke AEMail from the shell without any parameters, AEMail will
  2155.     behave the same as if it was invoked from the Workbench by clicking
  2156.     on it's icon except that tool types will not be utilized.  That action 
  2157.     is described below.
  2158.  
  2159.     AEMail can be run either in an offline or online mode.  This means that
  2160.     your TCP/IP stack does not have to be running when AEMAIL is activated.  
  2161.     However, to actually receive or send mail via your Internet provider, 
  2162.     you must have your TCP/IP stack (AmiTCP, TermiteTCP, Miami, etc) running 
  2163.     and connected to your provider.  You can activate AEMAIL before 
  2164.     activating your TCP/IP stack or after; it makes no difference.
  2165.  
  2166.     A convenient menu item has been provided in AEMAIL to start your TCP/IP
  2167.     stack ("TCP/IP/Start Net") after AEMAIL is up and running provided a
  2168.     script can be used to start your TCP/IP stack.  If a script is not
  2169.     provided for this purpose, AEMail will iconify an allow you to start
  2170.     your TCP/IP stack manually.  A menu item has also been provided to stop
  2171.     the TCP/IP stack.
  2172.  
  2173.     You can also automatically activate your TCP/IP stack at program startup 
  2174.     by providing the AUTOCONNECT=YES Tool Type described above or by check 
  2175.     marking the "Automatic connection to Internet Provider on AEMAIL Start Up"
  2176.     in the TCP/IP Page of the configuration screen.  WARNING: for this to
  2177.     work, you will need to be able to activate your TCP/IP stack automatically 
  2178.     by a script.
  2179.  
  2180.     To activate AEMAIL simply double click on the AEMAIL icon.  You can
  2181.     also activate AEMAIL from the shell, but, if activated in this manner,
  2182.     it will not have access to the configuration information provided
  2183.     by Tool Types.  It does, however, have access to the configuration
  2184.     information in the specified AEMail configuration file (either 
  2185.     s:aemail.cnfg or the file specified with config=).
  2186.  
  2187.     AEMAIL opens on it's own 16 color Public Screen.  The Public Screen
  2188.     name is "AEMAIL-1".  8 of the colors are defined by the first eight
  2189.     colors of the workbench screen.  The remaining 8 colors are pre-defined
  2190.     with the following colors: Red (13R, 0B, 0G), Green (0R, 15G, 0B),
  2191.     Blue (0R, 0G, 15B), Magenta (15R, 0G, 15B), Yellow (15R, 15G, 0B),
  2192.     Orange (15R, 10G, 0B), Brown (10R, 5G, 0B), and Purple (9R, 3G, 9B).
  2193.     These colors have been preset to provide a consistant color scheme
  2194.     for displaying icons and folder tab colors.  Under consideration is
  2195.     the possibility of allowing these colors to be user settable in the
  2196.     future.
  2197.  
  2198.     Since multiple windows are opened by AEMAIL, the program opens on
  2199.     it's own screen to allow uniformity in being able to push the screen
  2200.     to the back (with all of it's member windows) and back again to the
  2201.     front.  The LEFT-AMIGA-M key can be used for this purpose.
  2202.  
  2203.     You can also iconify AEMAIL with an iconify bar on the Workbench screen.
  2204.     A menu item has been provided to perform the iconify action.  When this
  2205.     menu item is selected, the AEMAIL screen will disappear and a button bar
  2206.     will appear on the Workbench screen with
  2207.  
  2208.         AEMAIL (Click on Close or with RMB to restore)
  2209.  
  2210.     in the title.  When the iconified bar is selected, clicking either on the
  2211.     close gadget or with the RMB will restore the AEMAIL screen.
  2212.  
  2213.     There is also a hotkey provided for iconifying AEMAIL.  This is 
  2214.     RIGHT-AMIGA-I.  This same hot key will also take AEMAIL out of 
  2215.     iconify mode.  The LEFT-AMIGA-I key will also accomplish this.
  2216.  
  2217.     Periodically during the running of AEMAIL, the program will automatically
  2218.     switch to the workbench screen for executing certain functions and then
  2219.     switch back when the function is complete.
  2220.  
  2221.     The first thing AEMAIL does when it is activated is to check to see that
  2222.     certain configuration information has been provided.  The necessary
  2223.     items are:
  2224.  
  2225.         POP3 UserID
  2226.         Password
  2227.         Your email address
  2228.         SMTP Domain Name
  2229.         Edit Call
  2230.  
  2231.     If these items have not be provided, the following requester will be
  2232.     displayed:
  2233.  
  2234.         The following Configuration items are empty
  2235.  
  2236.         [list of empty items]
  2237.  
  2238.         They are required items!
  2239.  
  2240.     The Pop Server call and the SMTP Server call will also be included in this
  2241.     list if the Domain Name is missing.
  2242.  
  2243.     If this requester is displayed, you will be given the following choices:
  2244.  
  2245.            [Configure AEMAIL now]               [Cancel AEMAIL]
  2246.  
  2247.     If you were to click on [Cancel AEMAIL], AEMAIL will terminate.  You can
  2248.     not proceed any further until you have entered these items with the
  2249.     Configuration screen or by providing them as Tool Types.
  2250.  
  2251.     Clicking on the [Configure AEMAIL now] will bring up the Configuration
  2252.     screen which was described previously.
  2253.  
  2254.     After verifying that required configuration information has been provided,
  2255.     AEMAIL will check to see if you are connected to your Internet provider.
  2256.     If it is, connection will be made to your POP server to see if there are 
  2257.     any messages available on the server in your mail box.  If there are, the 
  2258.     following requester will appear:
  2259.  
  2260.               n Messages Available on the POP Server
  2261.  
  2262.             Do you wish to receive these messages now?
  2263.  
  2264.     If you click on the [YES] button, those message will be retrieved at 
  2265.     this point.   See the RETRIEVE MESSAGES command described in Section VI. 
  2266.     COMMAND ICON STRIP for details on this process.
  2267.  
  2268.     If you click on [NO], no message retrieval will take place at this time.  
  2269.     You will need to retrieve these messages later using the RETRIEVE MESSAGES
  2270.     command icon.
  2271.  
  2272.     After AEMAIL checks to see if any messages are available on the POP Server,
  2273.     it also checks to see if any messages are in the QUEUED folder (messages
  2274.     queued to be sent).  If there are, the following requester will appear:
  2275.  
  2276.              You have n messages queued to be sent
  2277.  
  2278.             Do you wish to send these messages now?
  2279.  
  2280.     If you click on the [YES] button, all of the messages in the QUEUED folder
  2281.     will be sent immediately.  This is the same as selecting the "Send Queued
  2282.     Mail" item under the "Project" menu or selecting the QUEUED FOLDER and
  2283.     clicking on the "Send Message Immediately" command icon (see Sections
  2284.     VI. Command Icon Strip and VII. AEMAIL MENUS below).
  2285.  
  2286.     If you click on [NO], the queued messages will not be sent at this time.
  2287.     You will need to send these messages later using either the "Send Queued
  2288.     Mail" item under the "Project" menu or selecting the QUEUED FOLDER and
  2289.     clicking on the "Send Message Immediately" command icon.
  2290.  
  2291.     If you successfully connected at program startup the following message will
  2292.     appear in the Title bar of the AEMAIL screen:
  2293.  
  2294.         TCP/IP session started with [Your-POP-Server-Name]
  2295.  
  2296.     If you were not connected the following message will appear in the Title bar:
  2297.  
  2298.         Not Connected to [Your-POP-Server-Name] Host
  2299.  
  2300.     You can disable either or both the POP mail check or the queued mail check
  2301.     at startup by checkmarking the appropriate items in the TCP/IP Page of the
  2302.     Configuration screen.
  2303.  
  2304.     When AEMAIL first starts, three windows are opened in horizontal bands
  2305.     on the AEMAIL screen.  This main window is displayed just below the screen
  2306.     menu/title bar and provides a contextual help title bar and a command icon
  2307.     strip.  This strip provides icons for accessing the major functions of AEMAIL
  2308.     and consists (from left to right) of the following icons: Display Folder
  2309.     List, Display Address Book, Display Previous Message, Display Next
  2310.     Message, Save Message To File, Print Selected Messages, Delete/Undelete
  2311.     Message, Compose a Message, Send Message Immediately, Queue Message
  2312.     for Later Delivery, and Retrieve Messages.  Currently these icons are
  2313.     in black and white, but a future release will provide colored icons with
  2314.     more detailed displays.
  2315.  
  2316.     The window below the command strip window contains a "folder strip" set
  2317.     of icons.  An icon is provided for each folder with a colored "tab" to
  2318.     indicate the type of folder (of the user's own choosing).  Below each folder
  2319.     icon is a short name (not exceeding 9 characters) for that folder.
  2320.     Inside the folder is the total number of messages.  It may be followed
  2321.     by the number of un-read messages in parenthesis.  If there are unread
  2322.     messages, both numbers will be displayed in red.  These messages counts
  2323.     will be updated as messages are added to the folders.  Currently deleted
  2324.     messages are not subtracted from these counts.  The counts reflect the
  2325.     actual number of messages in the folder whether they are marked for
  2326.     deletion or not.
  2327.  
  2328.     Four pre-defined folders are provided: "INBOX" for holding retrieved
  2329.     messages, "PENDING" which holds messages that the user is currently
  2330.     composing and has not decided to send as yet, "QUEUED" which holds
  2331.     completed messages for later transmission, and "SENT" which holds
  2332.     messages that have been sent and accepted by the SMTP Server.  Since
  2333.     these folders must always be present, you can not delete or change
  2334.     the name of these folders.
  2335.  
  2336.     A facility has been provided to allow the user to add as many additional
  2337.     folders of his own choosing that he wants to the list of folders.  As each
  2338.     new folder is created, an icon will be created and placed next to the
  2339.     last folder icon.  Any number of folders can be created and the "folder strip"
  2340.     has the ability to scroll horizontally so that all of the folder icons
  2341.     can be viewed and accessed.
  2342.  
  2343.     You can use the menu items "Transfer..." and "Copy..." under the MESSAGE
  2344.     menu to transfer or copy messages between folders.
  2345.  
  2346.     The last window is placed below the "folder strip" and is used to
  2347.     display either folder lists, address books, message lists, or messages
  2348.     themselves. If a non-interlaced screen is provided, the message and
  2349.     address book displays will start below the command strip (overlaying the
  2350.     folder strip) rather than below the folder strip.  This is done to
  2351.     provide more room for the message or address book display since the
  2352.     number of displayable lines is limited.
  2353.  
  2354.     Other windows are also provided which cover the entire screen below the
  2355.     title bar for the purpose of providing configuration information and for
  2356.     composing messages.
  2357.  
  2358.     Each of the windows is described in detail in the WINDOW section
  2359.     below.
  2360.  
  2361.     While the command and folder strips are being displayed, a contextual
  2362.     help line is provided in the main (command strip) window title bar below
  2363.     the screen's title bar.  As you pass the mouse cursor over any command or
  2364.     folder icon, a description of that command or folder will be displayed in
  2365.     the window title bar.  The main window menu bar should also be active 
  2366.     whenever the mouse pointer moves to the "folder strip" or above.
  2367.  
  2368.     All command and folder icons are surrounded by a raised box.  Whenever
  2369.     a command or folder is selected, the box will become depressed.
  2370.  
  2371.     When AEMail is first activated and you are online and have mail and accept 
  2372.     it's transfer, the message list for the INBOX folder will be displayed.  
  2373.     As each mail message is received you will see it added to the message 
  2374.     list of the INBOX.
  2375.  
  2376.     If you are offline or there is no mail or mail is not being checked, the 
  2377.     folder list will be displayed.  Double clicking on either the name of a 
  2378.     folder in the list or one of the folder icons will cause the message list 
  2379.     for that folder to be displayed.
  2380.  
  2381.     Double clicking on a message in the message list will cause that
  2382.     particular message to be displayed.
  2383.  
  2384.     If you have selected a time increment in the Configuration screen (the
  2385.     default is 2 minutes), a background process will be started which checks
  2386.     your POP server every few minutes (as specified by the interval) for 
  2387.     messages.  If there are any messages, the following requester will pop up:
  2388.  
  2389.  
  2390.                               YOU HAVE MAIL!!
  2391.  
  2392.                   n Messages available on the POP Server
  2393.  
  2394.                 Do you wish to receive these messages now?
  2395.  
  2396.  
  2397.     Replying [YES] to the above requester will start the retrieval of the
  2398.     messages.  This requester will only pop up when you are not in the middle 
  2399.     of some function such as composing a message, transferring or saving a 
  2400.     message, printing a message, or performing configuration changes.  It
  2401.     will pop up on the Workbench screen if you have AEMail iconified.
  2402.  
  2403.     NOTE: if you did not specify that you wanted messages deleted from
  2404.     your POP server as you transferred them to your Amiga, the "YOU HAVE
  2405.     MAIL" requester will pop up each time the system checks for mail.
  2406.  
  2407.  
  2408. USING AEMail AS A "MailTo" AGENT
  2409.  
  2410.     A number of Amiga WWW Browsers allow you to select a Mail agent to
  2411.     be used for sending email when a "mailto:" HTML link is specified.
  2412.     AEMail can be used as such a mail agent.
  2413.  
  2414.     On the configuration screen for your browser specify AEMail as your
  2415.     "mailto:" agent by using the full path name of AEMail and the token
  2416.     for specifying the mailto email address.
  2417.  
  2418.     As an example, for Voyager you can specify the following:
  2419.  
  2420.         AmiTCP:bin/AEMail %h
  2421.  
  2422.     as the "mailto:" helper application in the "Network Settings: Other"
  2423.     Voyager menu or when you install Voyager.  Be sure and save your
  2424.     Voyager settings once you make the change.
  2425.  
  2426.     The "%h" in the above specification is Voyager's token for where to
  2427.     place the email address.  The specification also assumes that AEMail
  2428.     was installed in the AmiTCP:bin drawer.  Use the correct full path 
  2429.     for where you installed AEMail.  Voyager does not require a "pubscr=" 
  2430.     argument.
  2431.  
  2432.     Other browsers, if they use this capability, may have a different way
  2433.     to specify the "mailto" user agent.  Consult your browser documentation
  2434.     for how to do this.
  2435.  
  2436.     In AWeb, for instance, bring up the "Change Settings" menu and select
  2437.     "External programs" in the cycle gadget.  You enter the "mailto:"
  2438.     application call with two string gadgets.  The first string gadget
  2439.     specifies the Command string which would be "AmiTCP:bin/AEMail" (again
  2440.     the full path name) and the second string gadget specifies the
  2441.     Argument string which would be "%s pubscn=%s".  AWeb does use the
  2442.     public screen argument.
  2443.  
  2444.     In order for the "mailto:" agent to work properly, AEMail must NOT be
  2445.     running when you start up your browser.  When you click on the "mailto:"
  2446.     link, AEMail will be loaded, the Compose message window will be displayed,
  2447.     you will then be able to compose and send the message, and AEMail will
  2448.     terminate.
  2449.  
  2450.     If you have a custom configuration file, you should also add the
  2451.     argument "config=name-of-config-file" to the "mailto" calling argument.
  2452.     As an example, using Voyager:
  2453.  
  2454.         AmiTCP:bin/AEMail %h config=name-of-file
  2455.  
  2456.  
  2457. VI. COMMAND ICON STRIP
  2458.  
  2459. Below is a description of the "command strip" and the fuctions that
  2460. it performs:
  2461.  
  2462.  
  2463.   DISPLAY FOLDER LIST
  2464.  
  2465.     This icon looks like a file cabinet.  Clicking on the icon will cause
  2466.     the folder list to be displayed in the lower window.  This list shows
  2467.     each folder with its short name (INBOX, PENDING, etc), a description
  2468.     of the folder, the number of unread mesages in the folder, and the
  2469.     total number of messages in the folder.
  2470.  
  2471.     The total number of messages includes any messages marked for deletion.
  2472.  
  2473.  
  2474.   DISPLAY ADDRESS BOOK
  2475.  
  2476.     This icon looks like an open book.  Clicking on this icon will display
  2477.     the Address Book window.
  2478.  
  2479.     Each address book entry contains three fields: Nickname, Real Name,
  2480.     and UserID (Address).  In addition, entries can be provided for groups
  2481.     with a distribution list.  The group is identified with the heading
  2482.     "DISTRIBUTION LIST" in the top most UserID field and the UserID's
  2483.     for the members of that list are shown below that heading.
  2484.  
  2485.     For items in the distribution list, real UserID's or Nicknames can be
  2486.     used (Nicknames preferred).  An item in the distribution list can also
  2487.     be another distribution list (In this case, only a Nickname can be
  2488.     used).  All nicknames are expanded to Real Name and UserID when
  2489.     mail is sent.
  2490.  
  2491.     Currently, address book entries are sorted by Nickname and group
  2492.     entries are interspersed with single entries.  Also Real Names are
  2493.     presented as first name followed by last name rather than last name,
  2494.     first name.
  2495.  
  2496.     If you are displaying a message, or have a message selected, when you
  2497.     click on the Address Book icon, the "Reply-To:" address, if present,
  2498.     will be transferred to the UserID address in the Address Book.  If
  2499.     the Reply-To: address is not present, the From: address will be used.
  2500.     If a Real Name is present in the address it also will be transferred.
  2501.     You can force the From: address to be transferred by holding down
  2502.     the shift key when you click on the Address Book icon.  This process
  2503.     facilitates transferring names and UserIDs to the Address Book.
  2504.  
  2505.     The first time AEMAIL is loaded, a special Address Book entry with a
  2506.     nickname of "AEMAIL" is created.  This entry can be used to send
  2507.     bug reports and messages about AEMAIL to my email address.
  2508.  
  2509.     Address book data is stored in a file in your AEMAIL directory called
  2510.     ".addrbook".
  2511.  
  2512.     A more complete description of the Address Book window is given later.
  2513.  
  2514.  
  2515.   DISPLAY PREVIOUS MESSAGE
  2516.  
  2517.     This icon is a backward arrow.  When you are displaying a message,
  2518.     clicking on this icon will display the previous message in the message
  2519.     list.  If you are at the first message in the list, a requester will
  2520.     be displayed informing you of this.
  2521.  
  2522.     A more complete description of the message display window is given later.
  2523.  
  2524.  
  2525.   DISPLAY NEXT MESSAGE
  2526.  
  2527.     This icon is a forward arrow.  When you are displaying a message,
  2528.     clicking on this icon will display the next message in the message
  2529.     list.  If you are at the last message in the list, a requester will
  2530.     be displayed informing you of this.
  2531.  
  2532.     A more complete description of the message display window is given later.
  2533.  
  2534.  
  2535.   SAVE MESSAGE TO FILE
  2536.  
  2537.     This icon looks like a diskette.  A message must be selected before
  2538.     activating this function.  Only one message can be selected; multiple
  2539.     selection does not work with this command.  The message you want to save
  2540.     must be either highlighted in the message list or currently being
  2541.     displayed.
  2542.  
  2543.     Before saving the message, a requester will be displayed which will
  2544.     describe the message as to Date, From, To, and Subject and ask you if
  2545.     you want to perform the requested action.  Selecting [SAVE] will display
  2546.     a file requester in which you will be asked to enter the file name you
  2547.     want the message saved as, and selecting [CANCEL] will exit the function
  2548.     without performing the action.
  2549.  
  2550.     The complete message, including all attachments, is saved in the format
  2551.     in which the message was received from the POP server except that
  2552.     CARRAGE-RETURN/LINEFEED sequences are stored as LINEFEEDs alone.  Also,
  2553.     the message ending sequence (.<CR><LF>) is eliminated and any embedded
  2554.     ..<CR><LF> are changed to .<LF> as they would normally appear in a message.
  2555.     This facilitates conversion of messages from one AEMAIL version to another.
  2556.  
  2557.     If you want to save an attachment in its converted format, you can do
  2558.     that with the Attachment Requester that can be brought up when you
  2559.     display a message (see Attachment Requester under VIII. AEMAIL WINDOWS
  2560.     below).
  2561.  
  2562.  
  2563.   PRINT SELECTED MESSAGES
  2564.  
  2565.     This icon looks like a printer.  You must select the messages you want
  2566.     printed prior to selecting this icon.  Multiple message selection works
  2567.     with this command.
  2568.  
  2569.     Each of the messages will be printed in the order that they appear in your
  2570.     message list.  A progress indicator will appear as each message is being
  2571.     sent to your printer which shows the percent being printed and the total
  2572.     bytes being printed.  This progress indicator has an [ABORT] button which
  2573.     allows you to terminate the printing.  However, beware, most printers have
  2574.     a substantial buffer which will probably receive all of your messages
  2575.     quite quickly.  Once the messages are in the printer's buffer, the printing
  2576.     can not be cancelled without turning your printer off.
  2577.  
  2578.     A heading line will be printed on each page of the listing which contains
  2579.     the following information:
  2580.  
  2581.     Message Sent on MM/DD/YY (DOW) at HH:MM [AM/PM], [from/to] [name]  Page n
  2582.  
  2583.     where MM/DD/YY is the date the message was sent (received) or composed,
  2584.         DOW is the day of the week the message was sent (received) or composed,
  2585.         HH:MM is the hour and minute the message was sent (received) or composed
  2586.             using a 12 hour clock,
  2587.         [AM/PM] is either AM or PM.
  2588.         [from/to] if the message was received you will see "from", and if you
  2589.             composed or sent the message you will see "to",
  2590.         [name] the full name of the sender or nickname of recipient,
  2591.         [n] the page number.
  2592.  
  2593.     On the first page only, if there are attachments, the following line will
  2594.     appear below the heading line:
  2595.  
  2596.     This message has attachments (See last page for list).
  2597.  
  2598.     On a separate page after the message, the attachment list will appear,
  2599.     providing the "Include Attachment List in Print Out" item is checkmarked
  2600.     in the General Parameters portion of the Configuration screen.  Printing
  2601.     the attachment list is the default action.
  2602.  
  2603.     Note: no check is made whether a selected message is deleted or not.  If
  2604.     a deleted message is selected it will be printed anyway (this is probably
  2605.     desireable in certain circumstances).  If you don't want to print it,
  2606.     de-select it!
  2607.  
  2608.     This function can also print a list of all messages in a folder.  To do this,
  2609.     DO NOT select any messages in the folder.  A requester will appear when you
  2610.     select either the printer command icon or the Print menu item which says:
  2611.  
  2612.  
  2613.                            No messages selected to print!
  2614.  
  2615.                             Do you want to print a list
  2616.                             of all the messages in the
  2617.                              [name of folder] folder?
  2618.  
  2619.                           [YES]                     [NO]
  2620.  
  2621.     By selecting [YES] you will print a list of the messages.  Messages will be
  2622.     printed in the order that they appear in the message list.
  2623.  
  2624.     Selecting [NO] will terminate the printing function.
  2625.  
  2626.     Printing uses your Preferences Printer.  You should set it up properly
  2627.     before executing AEMAIL, but you can set it up while in AEMAIL by using
  2628.     the General Parameters display on the Configuration screen.  You can also
  2629.     specify a print file that the output will be directed to.
  2630.  
  2631.     As a default AEMAIL will space 4 lines down before starting to print.
  2632.     This "Top Margin", however, can be changed in the General Parameters
  2633.     section of the Configuration screen.
  2634.  
  2635.  
  2636.   DELETE/UNDELETE MESSAGE
  2637.  
  2638.     This icon looks like a garbage can.  This will delete OR undelete all
  2639.     messages that have been selected in a message list.  Whether deleting or
  2640.     undeleting takes place depends on the current status of the message.
  2641.     If it is currently marked for deletion, it will be undeleted.
  2642.  
  2643.     This function only marks (or unmarks) messages for deletion.  The
  2644.     messages will actually be deleted only when AEMAIL exits.
  2645.  
  2646.  
  2647.   COMPOSE A MESSAGE
  2648.  
  2649.     This icon looks like a sheet of paper with a pen on it.  The Compose a
  2650.     Message function brings up the Compose Message window which is described
  2651.     under Section VII, AEMAIL Windows.  In this window you will enter
  2652.     information about the message you are about to compose.  The information
  2653.     you enter includes the Nickname or UserID of the receipient of the
  2654.     message, the subject and whether or not you want to send cc's to anyone.
  2655.     You can also specify any attachments you want to send with the message
  2656.     through the Add Attachment Requester.
  2657.  
  2658.     After supplying the required information, your editor will be called and
  2659.     you will then compose your message text.
  2660.  
  2661.     If a message has been selected in any folder, except the PENDING, QUEUED,
  2662.     or SENT folders, before clicking on this icon, the compose will be treated
  2663.     as either a reply to the selected message or you will be allowed to compose
  2664.     a new message to be sent to a different (or same) recipient.
  2665.  
  2666.     If you want to forward a message you will have to use the "Forward..." sub-item
  2667.     in the Messages menu.
  2668.  
  2669.     If the message selected was in the PENDING or QUEUED folder, you will be
  2670.     allowed to either edit the selected message or create a new message.  If you
  2671.     edit the message it will be stored back into the PENDING folder and the old
  2672.     message will be deleted.  If the message selected was in the SENT folders,
  2673.     you will only be able to create a new message.
  2674.  
  2675.     After your message has been composed it will automatically be placed in the
  2676.     PENDING folder.  You can then send the message by either clicking on the
  2677.     SEND MESSAGE IMMEDIATELY icon or queue it for later delivery by clicking on
  2678.     the QUEUE MESSAGE FOR LATER DELIVERY icon.
  2679.  
  2680.  
  2681.   SEND MESSAGE IMMEDIATELY
  2682.  
  2683.     This icon looks like an envelope with an arrow going out.  An attempt
  2684.     will be made to send the Selected Message(s) to their recipients.
  2685.     The messages to be sent must be in either the PENDING or QUEUED folder.
  2686.     The messages will be sent from the QUEUED folder only if the QUEUED folder
  2687.     is selected; otherwise they will be sent from the PENDING folder.
  2688.  
  2689.     If messages are selected, a requester will appear that asks:
  2690.  
  2691.         Do you wish to send the entire [pending/queued] folder
  2692.         or just selected messages?
  2693.  
  2694.     The choices available are:
  2695.  
  2696.         [ENTIRE FOLDER]     [SELECTED MESSAGES]     [CANCEL SEND]
  2697.  
  2698.     If no messages have been selected, the entire selected folder will
  2699.     be sent without a requester appearing.  Deleted messages are never sent.
  2700.  
  2701.     If there are no undeleted messages in the selected folder a notification
  2702.     requester will appear that indicates that "No messages available to send".
  2703.  
  2704.     A check will then be made to see if AmiTCP is active.  If it is not, a
  2705.     requester will be displayed which informs the user that we are in offline
  2706.     mode and that the messages can not be sent (unless the SIMSMTP=YES tool
  2707.     type was set).
  2708.  
  2709.     If AmiTCP is active and a connection has been made to your Internet
  2710.     provider, a message will appear in the top title bar that says
  2711.     "Connecting to SMTP Host to send mail".  Once the connection is
  2712.     made. AEMAIL will display "Starting to send n messages" where n is
  2713.     the number of messages selected to send.  If we are unable to connect
  2714.     or an error is reported back from your Internet provider, a requester
  2715.     will be displayed showing the nature of the error and the messages will
  2716.     not be sent.
  2717.  
  2718.     A progress window will also be displayed which will show the current
  2719.     number of the message being sent, the total number of messages being
  2720.     sent, the percentage of the current message already sent and the total
  2721.     bytes in the current message being sent.  The percentage will be shown
  2722.     as both a number and a graphic slider.
  2723.  
  2724.     This progress window also has an [ABORT] button which allows you to
  2725.     terminate the sending of the current and all remaining messages to
  2726.     your SMTP Server.
  2727.  
  2728.     All nicknames used in To:, cc:, and bcc: header fields will be
  2729.     expanded to the form: Real Name<userid>.  Group nicknames will
  2730.     be expanded to the Real Names and userids of all members of the group.
  2731.  
  2732.     When each message is successfully sent, the following message will be
  2733.     displayed in the upper title bar:
  2734.  
  2735.         Mail n of n successfully sent to [To: addressee]
  2736.  
  2737.     The n in the above message indicates the message number and the total
  2738.     messages to be sent.  The [To: addressee] indicates who the message was
  2739.     addressed to.  If it was addressed to multiple addressees, the first
  2740.     addressee will appear followed by ", et al...".
  2741.  
  2742.     The message will also be placed in the SENT folder and marked as deleted
  2743.     in the PENDING or QUEUED folder.
  2744.  
  2745.     In the current version of AEMAIL, the send process operates in the
  2746.     same execution mode as AEMAIL.  This means that you can not perform any
  2747.     other AEMAIL operation until the message is either rejected by your
  2748.     Internet provider or successfully received by your provider (unless you
  2749.     abort the process).  In a future version, this process will be moved to
  2750.     a background process so that you can perform work in AEMAIL while the
  2751.     sending of the message proceeds.
  2752.  
  2753.  
  2754.   QUEUE MESSAGE FOR LATER DELIVERY
  2755.  
  2756.     This icon looks like a mailbox.  This function is provided to allow
  2757.     the user to mark messages that you want sent later.  NO MORE EDITING
  2758.     OF THESE MESSAGES can occur once they are moved to the QUEUED folder.
  2759.     However, messages can be moved back to the PENDING folder with the
  2760.     "Transfer..." menu item.  Messages for queuing must come from the
  2761.     PENDING folder.
  2762.  
  2763.     You can send these messages manually from the QUEUED folder any time
  2764.     you want by either sending the entire folder or individual messages in
  2765.     the folder.  This is done by selecting the QUEUED folder and clicking on
  2766.     the SEND IMMEDIATE icon (see above) or by selecting the "Send Queued
  2767.     Mail" menu item under the PROJECT menu.
  2768.  
  2769.     AEMAIL also allows the user the option of sending queued messages
  2770.     automatically when AEMAIL is first activated, or when the program
  2771.     terminates provided AmiTCP is up and running and you are connected to your
  2772.     Internet provider (see Section V. STARTING AEMAIL, above).  It will also
  2773.     perform this check when you make connection to your Internet provider
  2774.     through the StartNet script unless you have disabled this feature with
  2775.     the TCP/IP Parameters section of your Configuration screen.
  2776.  
  2777.     If messages are selected in the PENDING folder when you click on the QUEUE
  2778.     MESSAGE icon, a requester will appear that asks:
  2779.  
  2780.         Do you wish to queue the entire pending folder
  2781.         or just selected messages?
  2782.  
  2783.     The choices available are:
  2784.  
  2785.         [ENTIRE FOLDER]     [SELECTED MESSAGES]     [CANCEL QUEUING]
  2786.  
  2787.     If no messages have been selected, the entire PENDING folder will
  2788.     be queued without a requester appearing.  Deleted messages in the
  2789.     PENDING folder are never queued.
  2790.  
  2791.     If there are no undeleted messages in the PENDING folder a notification
  2792.     requester will appear that indicates that "No messages available to queue".
  2793.  
  2794.     The messages that are selected will be placed in the QUEUED folder and
  2795.     marked as deleted in the PENDING folder.
  2796.  
  2797.  
  2798.   RETRIEVE MESSAGES
  2799.  
  2800.     This icon looks like an envelope with an arrow coming in.  When selected,
  2801.     AEMAIL will attempt to connect to the POP host server and transfer any
  2802.     mail at the server to your Amiga.
  2803.  
  2804.     If you are in offline mode (AmiTCP is not up or running or AEMAIL can
  2805.     not connect to your POP server), you will see a requester that asks:
  2806.  
  2807.  
  2808.            !! We are running in Offline mode !!
  2809.  
  2810.         Do you wish to receive messages from files?
  2811.  
  2812.  
  2813.     Clicking on [NO] will terminate the retrieval process.
  2814.  
  2815.     Clicking on [YES] will bring up a file requester which will allow you
  2816.     you to select one or more files.  The default directory for
  2817.     these files is "AMITCP:" since it is assumed that you are trying
  2818.     to bring in mail that was previously transferred using another
  2819.     mail user agent such as AmiPOP, AirMail, or Voodoo; however, you
  2820.     can switch to any other directory and bring in any file that is in
  2821.     email text format.  You can also change the default directory for
  2822.     retrieving off-line mail with the Path Parameters display on the
  2823.     Configuration screen.
  2824.  
  2825.     AEMAIL automatically recognizes mail stored as individual messages
  2826.     or as message streams (such as stored by AmiPOP).  The only requirement
  2827.     is that the message stream must separate messages with data beginning:
  2828.  
  2829.         ...<LF><LF>From [UserID]
  2830.  
  2831.     where [UserID] is the UserID specified in the USERID= tool type or with
  2832.     the Required Parameters display on the Configuration screen.
  2833.  
  2834.     It is also assumed that lines have been stored in the file ending
  2835.     in <LF> and not <CR><LF> (<CR> is $0D and <LF> is $0A).
  2836.  
  2837.     If you encounter a message stream that does not use the above to
  2838.     separate messages, please report what was used and what product was
  2839.     used to create the message stream.  A copy of the message stream on
  2840.     floppy or sent to me as an email attachment would be very handy.
  2841.  
  2842.     If AmiTCP is up and running and connection can be made to your POP
  2843.     mail server, all messages stored on the server will be transferred
  2844.     to the Amiga.  They will be stored as individual messages in the
  2845.     AEMAIL: directory with cryptic file names.
  2846.  
  2847.     A progress window will also be displayed which will show the number of
  2848.     the current message being received, the total number of messages being
  2849.     received, the percentage of the current message already received
  2850.     and the total bytes in the message being received.  The percentage will
  2851.     be shown as both a number and a graphic slider.
  2852.  
  2853.     This progress window also has an [ABORT] button which allows you to
  2854.     terminate the receipt of the current and all remaining messages from
  2855.     your POP Server.
  2856.  
  2857.     PLEASE NOTE: The abort process only aborts the receipt of messages into the
  2858.     AMIGA, It does NOT abort the transfer of data from the POP Server.  While
  2859.     AEMAIL disconnects from the server, the server may be unaware of this and
  2860.     continue to send the remainder of the message.  If AEMAIL attempts to
  2861.     re-establish contact with the Server while it is still sending the message
  2862.     AEMAIL may start to receive the middle of the previously requested message.
  2863.     AEMAIL has been programmed to recognize this and will temporarily report that
  2864.     the POP connection could not be established.  Once the POP Server
  2865.     finishes transferring the message, it should become available for another
  2866.     connection.
  2867.  
  2868.     The progress window will be shown both when retrieving messages from
  2869.     your POP server and from files, hyowever, if you are retrieving a message
  2870.     stream, AEMAIL will not be able to correctly determine the number of
  2871.     messages being retrieved.  Therefor the "n of n" indicator will be
  2872.     incorrect.
  2873.  
  2874.     If mail on the server is to be deleted, the menu sub-item "Delete Host
  2875.     Mail" in the Retrieve Messages menu item must be checked.  If this menu
  2876.     sub-item is not checked, mail will NOT be deleted on your POP server.
  2877.     This has no effect when you are retrieving messages from a file.  NOTE:
  2878.     the AEMAIL Installation script automatically defaults to deleting host
  2879.     mail.  You will have to un-check this item if you want to keep mail on
  2880.     your POP Server.
  2881.  
  2882.     Since old mail may not be deleted on your server, a menu sub-item
  2883.     has been provided under the Retrieve Messages menu item called
  2884.     "Excl Dup Msgs".  When this sub-item is checked duplicate messages
  2885.     from the mail server which are currently stored in any incoming folder
  2886.     will not be stored again.  The only folders not checked for duplicate
  2887.     messages are the PENDING, QUEUED and any folder designed to hold SENT
  2888.     messages.    Again, the default action with the installation script is
  2889.     to delete duplicate messages.
  2890.  
  2891.     Currently, like sending messages to your Internet provider, the retrieval
  2892.     process is run in the same execution mode as AEMAIL.  This means that all
  2893.     of the messages must be received from the POP host before any other
  2894.     AEMAIL process can take place.  Again, a future version will move the
  2895.     retrieval process to a background process so you can proceed with other
  2896.     AEMAIL functions while retrieval takes place.
  2897.  
  2898.     Every time a new message is retrieved AND stored, the total and new
  2899.     message counts in the folder list AND the folder icon strip will be
  2900.     updated.  Also the top title bar will display the following message:
  2901.  
  2902.         Message n of n retrieved[/deleted] from [POP server/file], [not] saved
  2903.  
  2904.     The first n indicates the current message number and the second n
  2905.     indicates the total number of messages being retrieved. (NOTE: This
  2906.     message will also appear when local mail files are being transferred, but
  2907.     the counts may not be accurate if you are retrieving from a message
  2908.     stream.  Also, the retrieval process from local files is so fast, you
  2909.     may only see the message for the last retrieval.)
  2910.  
  2911.     The [/deleted] will appear if the message has been deleted on the POP server
  2912.     and [not] will appear if the message was a duplicate and was not saved.
  2913.  
  2914.     You can check for messages on your POP server and retrieve these messages
  2915.     manually any time you wish by clicking on the RETRIEVE MESSAGES icon.  Also,
  2916.     the user has the option of retrieving messages automatically when AEMAIL is
  2917.     first activated (provided AmiTCP is up and running and you are connected
  2918.     to your Internet provider), each time you execute your "startnet" script
  2919.     from within AEMAIL, and when you quit AEMAIL.  You can also set a time
  2920.     interval in minutes in which AEMAIL will periodically check for new mail.
  2921.     This function is done in the background and if one or more messages are
  2922.     on your POP server, the following requester will pop up:
  2923.  
  2924.  
  2925.                               YOU HAVE MAIL!!
  2926.  
  2927.                   n Messages available on the POP Server
  2928.  
  2929.                 Do you wish to receive these messages now?
  2930.  
  2931.  
  2932.     Replying [YES] to the above requester will start the retrieval of the
  2933.     messages.  This requester will only pop up when you are in the main
  2934.     AEMAIL screen and are not in the middle of some function such as
  2935.     composing a message, transferring or saving a message, printing a
  2936.     message, or performing configuration changes.
  2937.  
  2938.     NOTE: if you did not specify that you wanted messages deleted from
  2939.     your POP server as you transferred them to your Amiga, the "YOU HAVE
  2940.     MAIL" requester will pop up each time the system checks for mail.
  2941.  
  2942.  
  2943.  
  2944. VII. AEMAIL MENUS
  2945.  
  2946.     Below is a list of all the current menus and menu sub-items and a description
  2947.     of their functions:
  2948.  
  2949.  
  2950.     Project menu
  2951.  
  2952.         Configuration...
  2953.  
  2954.             This has five submenu items for controlling your configuration.
  2955.             These sub-menu items are:
  2956.  
  2957.             Open...
  2958.  
  2959.                 This brings up a file requester which allows you to specify
  2960.                 a configuration file other than the standard "s:aemail.cnfg"
  2961.                 file.  Once you have opened this configuration file it
  2962.                 becomes your current active configuration.
  2963.  
  2964.             Edit...
  2965.  
  2966.                 The Configuration screen will be activated allowing complete
  2967.                 configuration data to be entered for the current active
  2968.                 configuration file.  See the description of the
  2969.                 Configuration screen previously under the IV. CONFIGURATION:
  2970.                 section in this document for details on the configuration 
  2971.                 screen.
  2972.  
  2973.             Save
  2974.  
  2975.                 This will save the current configuration settings in the
  2976.                 currently active configuration file.  It serves the same
  2977.                 purpose as the previously "Save Settings" menu item (AEMail
  2978.                 versions prior to 1.13) in  which all of the current settings 
  2979.                 including the current state of the "Display Full Hdr", 
  2980.                 "Incl Hdr in Resp", "Excl Dup Msgs" and "Delete Host 
  2981.                 Mail" menu items.
  2982.  
  2983.             Save As...
  2984.  
  2985.                 This is the same as "Save" except that a file requester
  2986.                 will be brought up which allow you to rename the current
  2987.                 active configuration file.  The new name becomes the 
  2988.                 new current active configuration file.
  2989.  
  2990.             Restore Default
  2991.  
  2992.                 This reads in the s:aemail.cnfg file OR the file specified
  2993.                 in the CONFIG= Tool Type OR the config= parameter on the
  2994.                 Shell call to AEMail.  The particular file that is used
  2995.                 is referred to as your "base configuration".  The base
  2996.                 configuration now becomes your currently active
  2997.                 configuration file.
  2998.  
  2999.  
  3000.         Send Queued Mail
  3001.  
  3002.             Will send all messages in the QUEUED folder.  See the
  3003.             SEND MESSAGE IMMEDIATELY command in the COMMAND ICON STRIP
  3004.             section above.  This action will also occur automatically
  3005.             when you first load and when you exit AEMAIL provided you
  3006.             are connected to your Internet provider.
  3007.  
  3008.  
  3009.         Iconify AEMAIL
  3010.  
  3011.             You can iconify AEMAIL with an iconify bar on the Workbench screen
  3012.             with this menu item.  When this menu item is selected, the AEMAIL
  3013.             screen will be closed and a button bar will appear on the Workbench
  3014.             screen with
  3015.  
  3016.                     AEMAIL (Click on Close or with RMB to restore)
  3017.  
  3018.             in the title.  When the iconified bar is in selected mode, clicking
  3019.             either on the close gadget or with the right mouse button will restore
  3020.             the AEMAIL screen.
  3021.  
  3022.             Initially the iconify bar will open at the top center of the
  3023.             Workbench screen, but it can be dragged anywhere on the screen.
  3024.             AEMAIL remembers where you dragged the bar so the next time
  3025.             you iconify, the bar will be at that new position.
  3026.  
  3027.             There is also a hotkey provided for iconifying AEMAIL.  This is
  3028.             RIGHT-AMIGA-I.  This hot key, and also LEFT-AMIGA-I,  will also
  3029.             restore the AEMAIL screen when in the iconify mode.
  3030.  
  3031.             When in iconify mode, periodic checking of mail on your POP server
  3032.             is still done.  If mail is found, the "YOU HAVE MAIL" requester
  3033.             will pop up on the Workbench mail.  You can retrieve the mail
  3034.             immediately by clicking on the YES gadget.  The requester will
  3035.             disappear and retrieval of messages will occur in the background
  3036.             and no progress indicator will appear.  When you return to the
  3037.             AEMAIL screen, the new messages will be in your INBOX folder.
  3038.  
  3039.             You can also push the AEMAIL screen to the back exposing the
  3040.             screen immediately behind the AEMAIL screen or the WorkBench
  3041.             screen by hitting LEFT-AMIGA-M when the AEMAIL screen is being
  3042.             displayed.  This is standard Amiga action.
  3043.  
  3044.             If the AEMAIL screen has been pushed to the back, hitting
  3045.             LEFT-AMIGA-M will bring the screen forward.  Note: if other
  3046.             screens, besides the Workbench screen, are also present, they
  3047.             may be moved to the front first so that you may have to hit
  3048.             LEFT-AMIGA-M several times before the AEMAIL screen appears.
  3049.  
  3050.             Since there is no screen to bring forward, this will not work
  3051.             if the iconify action has been taken.
  3052.  
  3053.  
  3054.         About...
  3055.  
  3056.             This will display the name, version, and date of the program
  3057.             followed by information  as to whether or not the shareware 
  3058.             registration message has been received and who the version is 
  3059.             registered to (with serial number).
  3060.  
  3061.             Below that is information on how to contact the author of the
  3062.             program.
  3063.  
  3064.  
  3065.         Quit...
  3066.  
  3067.             Exits AEMAIL.
  3068.  
  3069.             When this menu item is selected, AEMAIL first checks to see
  3070.             if you are connected to your Internet provider.  If you are, a
  3071.             connection will be made to your POP server to see if there are
  3072.             any messages available on the server.  If there are, the following
  3073.             requester will appear:
  3074.  
  3075.                       n Messages Available on the POP Server
  3076.  
  3077.                     Do you wish to receive these messages now?
  3078.  
  3079.             If you click on the [YES] button, those message will be retrieved
  3080.             at this point. If you click on [NO], no message retrieval will take
  3081.             place.
  3082.  
  3083.             After AEMAIL checks to see if any messages are available on the
  3084.             POP Server, it also checks to see if any messages are in the
  3085.             QUEUED folder (messages queued to be sent).  If there are, the
  3086.             following requester will appear:
  3087.  
  3088.                      You have n messages queued to be sent
  3089.  
  3090.                     Do you wish to send these messages now?
  3091.  
  3092.             If you click on the [YES] button, all of the messages in the QUEUED
  3093.             folder will be sent immediately. If you click on [NO], the queued
  3094.             messages will not be sent.
  3095.  
  3096.             After checking for POP messages and QUEUED messages, the following
  3097.             requester will appear:
  3098.  
  3099.                 Do you wish to terminate your Host connection now?
  3100.  
  3101.             Selecting the [YES] button will cause the "stopnet" script to be
  3102.             executed terminmating your TCP/IP connection to your Internet
  3103.             provider.
  3104.  
  3105.             You can disable all of these requesters with a checkmarked item
  3106.             in the TCP/IP display on the Configuration screen.  If they are
  3107.             disabled, the [NO] action will be assumed which each of the
  3108.             requesters.
  3109.  
  3110.             Finally, a requester will be displayed that asks:
  3111.  
  3112.                 Do You Really Want to Quit?
  3113.  
  3114.             Clicking on [YES] will terminate the program and [NO] will return to
  3115.             the program.
  3116.  
  3117.             When AEMail exits, all messages marked for deletion will be
  3118.             deleted and any configuration files in which data has been updated
  3119.             will be re-written.  You will probably see a great deal of disk
  3120.             activity at this time.  While this disk activity is going on, a
  3121.             window will be displayed on the Workbench screen saying:
  3122.  
  3123.  
  3124.                      Updating all AEMail Configuration Files!
  3125.  
  3126.  
  3127.             When updating is complete, this window will disappear.
  3128.             WARNING: DO NOT turn your computer off while this window is being
  3129.             displayed.  If you do your disk will be corrupted!
  3130.  
  3131.  
  3132.     Folders menu
  3133.  
  3134.         New...
  3135.  
  3136.             The Configure Folder window will be activated indicating
  3137.             that a new folder should be created.  See the description
  3138.             of the Configure Folder window later in this document for
  3139.             details on how to create a new folder.
  3140.  
  3141.         Edit...
  3142.  
  3143.             The Configure Folder window will be activated indicating
  3144.             that the current selected folder description should be
  3145.             edited.  The current selected folder is the folder that
  3146.             has a depressed frame.  You can change the selected folder
  3147.             by single clicking on the appropriate folder icon or selecting
  3148.             a folder from the folder list.  See the description of the
  3149.             Configure Folder window later in this document for details
  3150.             on how to change the folder description.
  3151.  
  3152.         Delete...
  3153.  
  3154.             This will delete the folder that has been selected.  You will
  3155.             not be able to delete a folder that has active messages in it.
  3156.             If there are deleted messages in the folder, the messages
  3157.             will be immediately deleted along with the folder.  There
  3158.             is no way you can get these deleted messages back.
  3159.  
  3160.         Set Sort Key...
  3161.  
  3162.             Activates the Set Sort Key window for the current selected
  3163.             folder.  See the description of the Set Sort Key window later
  3164.             in this document for details on how to set the folder sort
  3165.             keys.
  3166.  
  3167.         Remove DELETED msgs
  3168.  
  3169.             This will IMMEDIATELY delete ALL messages marked for deletion 
  3170.             in the current active folder.  This means that they will no 
  3171.             longer appear in the message list for that folder and they 
  3172.             will be physically deleted from your mail directory.
  3173.  
  3174.             Before actually removing the messages the following requester
  3175.             will appear:
  3176.  
  3177.                    This will remove all deleted messages in the
  3178.                              [folder_name] folder
  3179.                     If you continue you can not retrieve them!
  3180.  
  3181.             You will given the option to either [CONTINUE] or [CANCEL].  If
  3182.             you select [CONTINUE] all the messages marked for deletion in
  3183.             the folder will be removed.  [CANCEL] will abort the operation.
  3184.  
  3185.             A busy pointer will be displayed while the messages are being
  3186.             removed.
  3187.  
  3188.  
  3189.  
  3190.     Messages menu
  3191.  
  3192.         Compose...
  3193.  
  3194.             Activates the Compose Message window, described later in
  3195.             this document, to create a NEW message to be sent whether
  3196.             or not a message is currently selected.
  3197.  
  3198.         Reply...
  3199.  
  3200.             Activates the Compose Message window to reply to the current
  3201.             selected message.  See the description of the Compose
  3202.             Message window later in this document.
  3203.  
  3204.             If a message is not selected when this menu item is activated
  3205.             an error requester will appear.
  3206.  
  3207.         Forward...
  3208.  
  3209.             Activates the Compose Message window to forward the current
  3210.             selected message.  See the description of the Compose
  3211.             Message window later in this document.
  3212.  
  3213.             If a message is not selected when this menu item is activated
  3214.             an error requester will appear.
  3215.  
  3216.         Edit...
  3217.  
  3218.             Using this menu item will allow you to edit a message selected 
  3219.             in either the PENDING or QUEUED folders.  It has the same effect 
  3220.             as clicking on the Compose icon when you have selected a message 
  3221.             in either the PENDING or QUEUED folders.
  3222.  
  3223.             If you have not selected a message in either the PENDING or
  3224.             QUEUED folder when this menu item is activated an error requester 
  3225.             will appear.
  3226.  
  3227.  
  3228.         Select None
  3229.  
  3230.             This menu item will de-select all messages in the selected folder.
  3231.  
  3232.         Select All
  3233.  
  3234.             This menu item will select all messages in the selected folder.
  3235.             Selected messages will be marked with an asterick (*) in the
  3236.             first position of the message in the message list display.
  3237.  
  3238.         Export...
  3239.  
  3240.             Same as the SAVE MESSAGE TO FILE command described previously
  3241.             in this document.
  3242.  
  3243.         Copy...
  3244.  
  3245.             This menu copies all selected messages from the selected folder
  3246.             to a new folder.  When you select this menu a Notification
  3247.             window appears which says:
  3248.  
  3249.  
  3250.                             Select Folder to Copy Messages To!
  3251.  
  3252.                                         [CANCEL]
  3253.  
  3254.  
  3255.             When the window appears, click on the folder icon that represents
  3256.             the folder you want the messages copied to.  The window will
  3257.             automatically disappear at that time.
  3258.  
  3259.             The selected messages will be copied to that folder.  Messages
  3260.             will remain in both folders.
  3261.  
  3262.             Clicking on [CANCEL] before clicking on a folder will cancel the
  3263.             operation.
  3264.  
  3265.             As the messages are being copied, the folder message list that the
  3266.             the messages are copied to will be displayed.  Once the copy is
  3267.             complete, the folder message list from which the messages are
  3268.             copied will be displayed.
  3269.  
  3270.  
  3271.         Transfer...
  3272.  
  3273.             This menu moves all selected messages from the selected folder
  3274.             to a new folder.  When you select this menu a Notification
  3275.             window appears which says:
  3276.  
  3277.  
  3278.                           Select Folder to Transfer Messages To!
  3279.  
  3280.                                         [CANCEL]
  3281.  
  3282.  
  3283.             When the window appears, click on the folder icon that represents
  3284.             the folder you want the messages transferred to.  The window will
  3285.             automatically disappear at that time.
  3286.  
  3287.             The selected messages will be copied to that folder, and the
  3288.             messages in the folder from which the messages are copied will
  3289.             be marked as "deleted".
  3290.  
  3291.             Clicking on [CANCEL] before clicking on a folder will cancel the
  3292.             operation.
  3293.  
  3294.             As the messages are being transferred, the folder message list
  3295.             that the the messages are transferred to will be displayed.  Once
  3296.             the transfer is complete, the folder message list from which the
  3297.             messages are copied and deleted will be displayed.
  3298.  
  3299.  
  3300.         Print
  3301.  
  3302.             Same as the PRINT SELECTED MESSAGES command described previously
  3303.             in this document.
  3304.  
  3305.  
  3306.         Delete/Undelete...
  3307.  
  3308.             Same as the DELETE/UNDELETE MESSAGE command described previously
  3309.             in this document.
  3310.  
  3311.         Display Full Hdr
  3312.  
  3313.             This is a checkmarked menu sub-item.  When checked, all message
  3314.             headers will be displayed in the message.  Since many of these
  3315.             headers are somewhat cryptic and could be confusing and not
  3316.             always understood by the user, the normal action is display
  3317.             only certain header lines.  The default action is to display
  3318.             the following headers: From:, To:, Date:, Subject:, cc:, and
  3319.             bcc:, but you can control this default minimum header list with
  3320.             the General Parameters display of the Configuration screen.
  3321.  
  3322.             This menu sub-item is very useful for debugging purpose to
  3323.             see all of the headers what any particular message carries.
  3324.  
  3325.             The current state of this checkmarked item is saved in the aemail.cnfg
  3326.             file whenever the "Save Settings" menu item is selected.  It can
  3327.             also be set or reset by the General Parameters display on the
  3328.             Configuration screen.
  3329.  
  3330.         Incl Hdr in Resp
  3331.  
  3332.             This is a checkmarked menu sub-item.  When checked the minimum
  3333.             header lines (To:, From:, Date:, Subject, cc:, and bcc:) will be
  3334.             included for the quoted message when composing a response.  If it
  3335.             is not checked, no header information will appear.
  3336.  
  3337.             The current state of this checkmarked item is saved in the aemail.cnfg
  3338.             file whenever the "Save Settings" menu item is selected.  It can
  3339.             also be set or reset by the General Parameters display on the
  3340.             Configuration screen.
  3341.  
  3342.  
  3343.  
  3344.     Retrieve Msgs menu
  3345.  
  3346.         From POP Host
  3347.  
  3348.             This will only retrieve messages from the POP Server.  See the
  3349.             RETRIEVE MESSAGES command described previously in this
  3350.             document for a full explanation of the retrieval process.
  3351.  
  3352.             If AmiTCP is not active or connection to the POP Server can
  3353.             not be made, the RETRIEVE MESSAGES command will return silently
  3354.             with the information that the POP Server could not be reached in
  3355.             the title bar.
  3356.  
  3357.         From Local File...
  3358.  
  3359.             This will only retrieve messages from a local file.  No attempt
  3360.             will be made to connect to the POP Server.  See the
  3361.             RETRIEVE MESSAGES command described previously in this
  3362.             document for a full explanation of the retrieval process.
  3363.  
  3364.             This menu sub-item allows you to retrieve messages from files
  3365.             even when online (connected to a host through AmiTCP).
  3366.  
  3367.         Excl Dup Msgs
  3368.  
  3369.             This is a checkmarked menu sub-item.  When checked, duplicate
  3370.             messages (ones that were previously retrieved and stored in one
  3371.             of AEMAIL's folders), will not be stored.  See the description
  3372.             under the RETRIEVE MESSAGES command for the use and full explanation
  3373.             of the function of this item.
  3374.  
  3375.             The current state of this checkmarked item is saved in the aemail.cnfg
  3376.             file whenever the "Save Settings" menu item is selected.  It can
  3377.             also be set or reset by the General Parameters display on the
  3378.             Configuration screen.
  3379.  
  3380.  
  3381.         Delete Host Mail
  3382.  
  3383.             This is a checkmarked menu sub-item.  When checked mail
  3384.             retrieved from your POP Server will be deleted after it is
  3385.             retrieved.  If it is not checked, mail will not be deleted
  3386.             and you will have to use the "Exl Dup Msgs" checkmark item
  3387.             discussed above to insure that a duplicate message are not
  3388.             retrieved the next time you retrieve messages.
  3389.  
  3390.             The current state of this checkmarked item is saved in the aemail.cnfg
  3391.             file whenever the "Save Settings" menu item is selected.  It can
  3392.             also be set or reset by the General Parameters display on the
  3393.             Configuration screen.
  3394.  
  3395.  
  3396.  
  3397.     TCP/IP menu
  3398.  
  3399.         Start Net
  3400.  
  3401.             This menu item makes connection to your Internet Provider.  It 
  3402.             executes the script that has been assigned by the Start Net
  3403.             Tool Type or the TCP/IP page of the Configuration screen.  If
  3404.             no Start Net script has been assigned, the action that is 
  3405.             performed is to iconify AEMail.  You can then perform the 
  3406.             network connection in what ever manner was provided by your 
  3407.             TCP/IP stack software.  Once the connection is made, un-iconify
  3408.             AEMail.
  3409.  
  3410.             When this menu item is selected and a "startnet" script has been
  3411.             assigned, the system will, by default, switch to the workbench 
  3412.             screen and execute the "startnet" script.  This allows the
  3413.             initial dialing window to display.  Once your Internet connection
  3414.             has been made the system will switch back to the AEMail screen.
  3415.  
  3416.             You can control the switching to the workbench screen by a check-
  3417.             marked item in the TCP/IP Parameters page on the Configuration
  3418.             screen.
  3419.  
  3420.             If you are using AmiTCP, the script that should be run is
  3421.             AmiTCP:bin/startnet; although the user may specify a different
  3422.             script and path with the STARTNET Tool Type or in the TCP/IP
  3423.             Parameters page on the Configuration screen.
  3424.  
  3425.             If you are using Miami, a "startnet.miami" script has been
  3426.             provided for connecting with your Internet provider.  This
  3427.             is usually run from the AEMail program directory.  This is
  3428.             an AREXX script so you will have to precede the script name
  3429.             with "rx " (see Section IV. CONFIGURATION for setting up
  3430.             your Start Net script).  This is set up automatically with
  3431.             the AEMail install provided a Miami: assignment is in the
  3432.             system.
  3433.  
  3434.             If you are using a TCP/IP stack that does not have a Start Net 
  3435.             script (such as TermiteTCP), you should be sure that the Start Net 
  3436.             call gadget in the TCP/IP parameters page of the Configuration 
  3437.             screen has been cleared.  Your Internet connection is then done 
  3438.             manually as explained above.
  3439.  
  3440.             Once a connection is made to your Internet provider and you have
  3441.             returned to the AEMail screen, a connection will be made to your 
  3442.             POP server to see if there are any messages available on the 
  3443.             server.  If there are, the following requester will appear:
  3444.  
  3445.                       n Messages Available on the POP Server
  3446.  
  3447.                     Do you wish to receive these messages now?
  3448.  
  3449.             If you click on the [YES] button, those message will be retrieved 
  3450.             at this point.  See the RETRIEVE MESSAGES command described in 
  3451.             Section VI. COMMAND ICON STRIP above for details on this process.
  3452.  
  3453.             If you click on [NO], no message retrieval will take place at this 
  3454.             time.  You will need to retrieve these messages later using the 
  3455.             RETRIEVE MESSAGES command icon.
  3456.  
  3457.             After AEMAIL checks to see if any messages are available on the
  3458.             POP Server, it also checks to see if any messages are in the
  3459.             QUEUED folder (messages queued to be sent).  If there are, the
  3460.             following requester will appear:
  3461.  
  3462.                      You have n messages queued to be sent
  3463.  
  3464.                     Do you wish to send these messages now?
  3465.  
  3466.             If you click on the [YES] button, all of the messages in the QUEUED
  3467.             folder will be sent immediately. If you click on [NO], the queued
  3468.             messages will not be sent.
  3469.  
  3470.             After the connection is made, the following message will be
  3471.             displayed in the screen's title bar:
  3472.  
  3473.                 TCP/IP Session started with [your-domain-name].
  3474.  
  3475.             If for any reason the connection can not be made, the following
  3476.             message will be displayed in the screen's title bar:
  3477.  
  3478.                 TCP/IP connection to [your-domain-name] failed
  3479.  
  3480.         Stop Net
  3481.  
  3482.             This menu item terminates the connection to your Internet Provider.
  3483.             It executes the script that has been assigned by the Stop Net
  3484.             Tool Type or the TCP/IP page of the Configuration screen.  If
  3485.             no Stop Net script has been assigned, the action that is 
  3486.             performed is to iconify AEMail.  You can then terminate the 
  3487.             network connection in what ever manner was provided by your 
  3488.             TCP/IP stack software.  Once the connection is terminated, 
  3489.             un-iconify AEMail.
  3490.  
  3491.             When this menu item is selected and a "stopnet" script has been
  3492.             assigned, the system will terminate the connection silently in
  3493.             the background.  Since no action is required by the user (unlike 
  3494.             "startnet"), the screen display will remain on the AEMail screen.
  3495.  
  3496.             If you want to switch to the Workbench screen while the connection
  3497.             is being terminated, you can do this through a check-marked item 
  3498.             in the TCP/IP Parameters page on the Configuration screen.
  3499.  
  3500.             If you are running AmiTCP, the script that should be run is
  3501.             AmiTCP:bin/stopnet; although the user may specify a different
  3502.             script and path with the STOPNET Tool Type or in the TCP/IP
  3503.             Parameters page on the Configuration screen.
  3504.  
  3505.             If you are running Miami, a "stopnet.miami" script has been
  3506.             provided for terminating the connection with your Internet 
  3507.             provider.  This script is usually run from the AEMail program 
  3508.             directory.  This is an AREXX script so you will have to precede 
  3509.             the script name with "rx " (see Section IV. CONFIGURATION for 
  3510.             setting up your Stop Net script).  This is set up automatically 
  3511.             with the AEMail install provided a Miami: assignment is in the
  3512.             system.
  3513.  
  3514.             If you are using a TCP/IP stack that does not have a Stop Net 
  3515.             script (such as TermiteTCP), you should be sure that the Stop Net 
  3516.             call gadget in the TCP/IP parameters page of the Configuration 
  3517.             screen has been cleared.  Your Internet connection is then 
  3518.             terminated manually as explained above.
  3519.  
  3520.             The following messages will be displayed in the screen's title
  3521.             bar when the connection is terminated:
  3522.  
  3523.                 TCP/IP session with [your-domain-name] terminated.
  3524.  
  3525.         TCP Logging File
  3526.  
  3527.             This has three submenu items for controlling your TCP Logging
  3528.             file.  Please read section IX. AEMAIL FILES, TCP Trace Log File
  3529.             for how to read the entries in this file.
  3530.  
  3531.             The sub-menu items are:
  3532.  
  3533.             Active
  3534.  
  3535.                 This is a checkmarked menu sub-item which indicates whether 
  3536.                 the TCP Logging is active or not.  If a TCP Logging File 
  3537.                 has not been defined with the Configuration screen, this sub-
  3538.                 item is ghosted.
  3539.  
  3540.                 Clicking on this item when it is not checkmarked will activate
  3541.                 TCP Logging.  Clicking on it when it is checkmarked will
  3542.                 deactivate logging.
  3543.  
  3544.             Purge
  3545.  
  3546.                 This is a handy way to delete all previous TCP Logging 
  3547.                 entries.  "Purge" will delete the current logging file and
  3548.                 open another file with the same name if logging is active.  
  3549.                 If logging is not active, the current logging file will be 
  3550.                 deleted, but a new file will not be opened until the Active
  3551.                 sub-item is checkmarked.
  3552.  
  3553.                 This menu item can be used whether the logging file is 
  3554.                 currently active or not.
  3555.  
  3556.             Display/Edit...
  3557.  
  3558.                 "Display/Edit" will call your editor to display the current
  3559.                 TCP logging file.  The logging file MUST NOT be Active in 
  3560.                 order to display or edit it.  If it is active you will get 
  3561.                 a requester that informs you that you can't display the 
  3562.                 file beause it is active.  If this happens, de-activate 
  3563.                 it by turning off the Active checkmark and then try the 
  3564.                 "Display/Edit" again.
  3565.  
  3566.                 If a TCP Logging file has not been defined in the Paths
  3567.                 page of the Configuration screen, you will receive a 
  3568.                 requester saying that it is not present.
  3569.  
  3570.                 NOTE:  The TCP logging file can become quite large and it 
  3571.                 may take some time for your editor to bring in the file.  
  3572.                 Some editors are slower than others in this regard.  If you
  3573.                 are using the AmigaDos editor (Ed), you will see a series of 
  3574.                 astericks (@) moving across the screen as the file is being
  3575.                 read in.  You might want to periodically purge the file (if it
  3576.                 is always active), to prevent a very large TCP Log file from
  3577.                 being created.
  3578.  
  3579.  
  3580.  
  3581.  VIII. AEMAIL WINDOWS
  3582.  
  3583.     Folder List Window
  3584.  
  3585.         The Folder List window will be displayed in the lower portion of
  3586.         the screen when AEMAIL is first loaded and whenever you click on
  3587.         the DISPLAY FOLDER LIST icon in the Command Icon Strip.
  3588.  
  3589.         The Folder List window looks like the following:
  3590.  
  3591.         =====================================================================
  3592.  
  3593.                                     Folder List
  3594.  
  3595.         Name      Description of Folder                     Not Read Total
  3596.         ---------------------------------------------------------------------
  3597.         INBOX     Messages Received                            nnnnn nnnnn| |
  3598.         PENDING   Messages composed and pending for action           nnnnn| |
  3599.         QUEUED    Messages Queued to be sent                         nnnnn| |
  3600.         SENT      Messages that have been sent                       nnnnn| |
  3601.         xxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx nnnnn nnnnn| |
  3602.         xxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx nnnnn nnnnn| |
  3603.                                                                           | |
  3604.         =====================================================================
  3605.  
  3606.         The folder list is a scrolling list.  Double clicking on any of the
  3607.         folders in the list will bring up the Message List window for that
  3608.         folder.  If the Folder Icon strip is also being displayed, double
  3609.         clicking on any particular folder icon will also bring up the message
  3610.         list for that folder.
  3611.  
  3612.         Single clicking on a item in the list or folder icon merely selects
  3613.         that folder.  The selected folder is then the folder referenced by
  3614.         the Folders Menu group items (Edit.., Delete..., Set Sort Key ...) and
  3615.         by such commands as Message Delete, Message Copy, Message Transfer, or
  3616.         Message Select All/NONE.
  3617.  
  3618.         One of the folders is always active (selected).  On program startup,
  3619.         the active folder will be INBOX.  You can always tell the current
  3620.         active folder by the depressed frame around the folder icon.
  3621.  
  3622.  
  3623.     Message List Window
  3624.  
  3625.         The Message List window will be displayed in the lower portion of
  3626.         the screen whenever you double click on either an item in the folder
  3627.         list or one of the folder icons.
  3628.  
  3629.         The Message List looks like the following:
  3630.  
  3631.         ========================================================================
  3632.  
  3633.             Message List for [folder-name] Folder ([folder Description...])
  3634.  
  3635.          FLGS Date     Time  From           Size Subject       (nnn messages)
  3636.         ------------------------------------------------------------------------
  3637.          NARF MM/DD/YY HH:MM xxxxxxxxxxxxx xxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  3638.         *NARF MM/DD/YY HH:MM xxxxxxxxxxxxx xxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  3639.          . . . . .                                                           | |
  3640.          NARF MM/DD/YY HH:MM xxxxxxxxxxxxx xxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  3641.                                                                              | |
  3642.         ========================================================================
  3643.  
  3644.         The column header line displays the number of messages in the
  3645.         folder as (nnn messages).
  3646.  
  3647.         The message descriptions are presented in a scrollable list.  The
  3648.         meaning of the various fields of each message description are as
  3649.         follows:
  3650.  
  3651.             FLGS:   (starts in the 2nd column)
  3652.                     N indicates an unread message
  3653.                     A indicates a message with attachments (NOT IMPLEMENTED)
  3654.                     R indicates the message is a reply
  3655.                     F indicates the message is a forwarded message.
  3656.                     D (in the same position as N) indicates the message is
  3657.                       a deleted message.
  3658.  
  3659.             Date:   This is the message date from the DATE: header in the
  3660.                     form of MM/DD/YY (2 digit month, 2 digit day, and the
  3661.                     last 2 digits of the year).
  3662.  
  3663.             Time:   This is the time the message was received in the form
  3664.                     of HH:MM (2 digit hour, 2 digit minute).  Time uses a
  3665.                     24 hour clock.
  3666.  
  3667.             From:   Is the Real Name (if present) from either the From: or
  3668.                     To: header.  If the folder represents messages being
  3669.                     sent from AEMAIL (PENDING, QUEUED, SENT) then this
  3670.                     field will be headed "To" and the To: header will be used.
  3671.                     If the Real Name is not present in the header, then the
  3672.                     UserID will be used instead.  If a Nickname is being
  3673.                     used for a message being sent, then the Nickname will
  3674.                     appear.
  3675.  
  3676.             Size:   This is the size, in bytes, of the message in the
  3677.                     form nnn,nnn.  If the size exceeds 999,999 bytes then
  3678.                     ***,*** will appear.  The size includes the size of
  3679.                     the message with all its attachments.
  3680.  
  3681.             Subject: Up to 39 characters from the Subject: header after
  3682.                     RE: and (fwd) are stripped.  You can tell if the
  3683.                     message is forwarded or is a reply by examining the
  3684.                     FLGS field.  RE: and (fwd) are stripped from the
  3685.                     Subject: header to allow sorting to place all
  3686.                     messages with the same subject (whether original,
  3687.                     replied, or forwarded) together.  You can also control
  3688.                     where 'replied' and 'forwarded' messages go in
  3689.                     the list since these use separate sorting criteria.
  3690.  
  3691.         An asterick (*) in the first position indicates that the message
  3692.         is selected.  This position will be blank if the message is not
  3693.         selected.
  3694.  
  3695.         The Message list can be sorted under a number of different
  3696.         categories (see Set Sort Keys window below).
  3697.  
  3698.         Double clicking on any message in the message list will bring
  3699.         up the message display window for that message.
  3700.  
  3701.         A single click will highlight and select the message.  An asterick
  3702.         will appear in the first column of the line indicating the message
  3703.         is selected.  You can click on another message to highlight and
  3704.         select that message.  Clicking on a message that is already selected
  3705.         will deselect the message.
  3706.  
  3707.         Only one message is highlighted.  If that message is selected it will
  3708.         be considered the current message for some operations (like DELETE/UNDELETE
  3709.         MESSAGE, SAVE MESSAGE TO FILE, and the message to reply to, forward, or
  3710.         edit when composing messages.
  3711.  
  3712.         Other operations such as DELETE/UNDELETE MESSAGE (depending on the
  3713.         option selected), COPY MESSAGE, TRANSFER MESSAGE, PRINT SELECTED MESSAGES,
  3714.         SEND MESSAGE IMMEDIATELY, and QUEUE MESSAGE FOR LATER DELIVERY will use
  3715.         the entire selected list of messages.
  3716.  
  3717.  
  3718.     Folder Configuration Window
  3719.  
  3720.         The Folder Configuration window will be displayed over the entire
  3721.         screen below the top title line when either the "New..." or "Edit..."
  3722.         menu items are selected from the Folders menu.
  3723.  
  3724.         The Folder Configuration window looks like the following:
  3725.  
  3726.         =====================================================================
  3727.  
  3728.                Folder Name: [         ]   (1 - 9 Characters only)
  3729.  
  3730.         Folder Description: [                                               ]
  3731.  
  3732.                  Tab Color: [@|  Red  |
  3733.  
  3734.             From/To Filter: [                                      ]  AND [ ]
  3735.                                                                        OR [ ]
  3736.             Subject Filter: [                                      ]  AND [ ]
  3737.                                                                        OR [ ]
  3738.                Date Filter: [                                      ]
  3739.  
  3740.                             [ ] Folder for Sent Messages          [SORT KEYS]
  3741.  
  3742.                       [ SAVE ]                  [CANCEL]
  3743.  
  3744.         ====================================================================
  3745.  
  3746.         If you are editing an existing folder, the Folder Name will be filled
  3747.         in, but the string gadget will be disabled.  You will not be able to
  3748.         modify it.
  3749.  
  3750.         If you are creating a new folder you must name it with a 1 to 9
  3751.         character folder name.  This will appear below the folder icon
  3752.         in the folder strip and in the folder list.
  3753.  
  3754.         The folder description can be up to 99 characters, but of course
  3755.         that many charcters will never appear anywhere.  Up to 52 characters
  3756.         will appear in the folder list display under "Description of Folder".
  3757.         This will also appear in the contextual help line in the window
  3758.         bar preceded by "Folder for"
  3759.  
  3760.         The Tab Color is a cycle gadget with the following possible values:
  3761.         Red, Green, Blue, Yellow, Orange, Magenta, Brown, or Purple.  This
  3762.         provides a color on the folder tab to help classify the folders
  3763.         according to the user's preferences.
  3764.  
  3765.         The next 3 string gadgets are designed for filters to help distribute
  3766.         in-coming messages to various folders.  THESE ARE NOT IMPLEMENTED
  3767.         AS YET AND AT THIS TIME ARE DISABLED.
  3768.  
  3769.         The checkbox gadget marked "Folder for Sent Messages" is used to
  3770.         indicate when a folder is for messages that have been sent or
  3771.         ready to be sent rather than in-coming folders.  The PENDING,
  3772.         QUEUED, and SENT folders all have this box checked.
  3773.  
  3774.         The [SORT KEYS] button is used to call the Set Sort Keys window
  3775.         (see below) to set the sort keys for the folder.
  3776.  
  3777.         Finally, you are given the choice of canceling the operation or
  3778.         saving the folder data in the folder.config file with the
  3779.         [CANCEL] and [SAVE] buttons.
  3780.  
  3781.  
  3782.     Set Sort Keys Window
  3783.  
  3784.         The Set Sort Keys window will be displayed over the entire screen
  3785.         below the top title line when either the "Set Sort Key..." menu item
  3786.         from the Folders menu is selected or the [Sort Keys] button is clicked
  3787.         in the Folder Configuration window.
  3788.  
  3789.         The Set Sort Keys window looks like the following:
  3790.  
  3791.         =====================================================================
  3792.  
  3793.                        1       2       3       4       5       6       7
  3794.         Priorities: ------- ------- ------- ------- ------- ------- -------
  3795.  
  3796.         Un-Read Messages: FIRST [ ]      Messages with Attachments: FIRST [ ]
  3797.         Priority [@|0|     LAST [ ]      Priority [@|0|              LAST [ ]
  3798.  
  3799.         Replied Messages: FIRST [ ]      Forwarded Messages: FIRST [ ]
  3800.         Priority [@|0|     LAST [ ]      Priority [@|0|       LAST [ ]
  3801.  
  3802.         Latest Date:      FIRST [ ]      Largest Messages: FIRST [ ]
  3803.         Priority [@|0|     LAST [ ]      Priority [@|0|     LAST [ ]
  3804.  
  3805.         Group by FROM at Priority [@|0|    Group by Subject at Priority [@|0|
  3806.  
  3807.         [ ] Order Received
  3808.                            --> at Priority [@|0|     [ ] Apply to all Folders
  3809.         [ ] Latest Received
  3810.  
  3811.                   [ USE ]           [ SAVE ]           [CANCEL]
  3812.  
  3813.         =====================================================================
  3814.  
  3815.         Messages in each of the folders can be displayed in various sort
  3816.         orders and each folder can have a different sort order.  Up to
  3817.         seven levels of sort priority can be given.  The various
  3818.         sorting criteria are shown on this window and a particular
  3819.         sort order can be given for any sort priority.  The sorting
  3820.         criteria for any particular priority is selected by the
  3821.         priority cycle gadget under or opposite each criteria.  A
  3822.         priority of 0 is used to indicate that this criteria is not
  3823.         used in the sort.
  3824.  
  3825.         To help visualize which criteria applies to which priority
  3826.         a list at the top of the window shows the current position
  3827.         of any particular sort criteria in the priority list.
  3828.         With the exception of priority 0 (no priority), no two
  3829.         criteria can have the same priority.  If this happens, **DUP**
  3830.         will appear for that priority in the priority list.
  3831.  
  3832.         If you want the sorting criteria to be used for all folders
  3833.         check the "Apply to all Folders" box.
  3834.  
  3835.         At the bottom of the window is the [USE], [SAVE], and [CANCEL]
  3836.         buttons.  If you want the sorting to apply only to this
  3837.         AEMAIL session select [USE].  If you want to make the sorting
  3838.         permanent, select [SAVE].  [CANCEL], of course, will abort
  3839.         the operation without setting any sort keys.
  3840.  
  3841.         If the this window was called from the Folder Configuration Window,
  3842.         selecting [USE], [SAVE], or [CANCEL] will return you to the Folder
  3843.         Configuration Window.
  3844.  
  3845.  
  3846.     Examples of Setting Sort Keys
  3847.  
  3848.         You may want your messages displayed in different orders in the
  3849.         Message Window.  This is the purpose of the "Set Sort Keys
  3850.         Window."
  3851.  
  3852.         Let's assume that you want your messages displayed with unread
  3853.         messages first.  Within both the unread and previously read
  3854.         sections you want the messages sorted by the latest date first.
  3855.         To do this click on the Un-Read Messages: FIRST box and set the
  3856.         priority underneath Un-Read Messages to 1.  Then click on the
  3857.         Latest Date: FIRST box and set it's Priority to 2.  Notice that
  3858.         as you change the Priority cycle gadget for Latest Date from
  3859.         0 to 1 to 2, you will see *DUP* appear in priority 1 as the
  3860.         Date moves through the priority 1 position.
  3861.  
  3862.         The final sort window for the above sorting priority will look
  3863.         like this:
  3864.  
  3865.         =====================================================================
  3866.  
  3867.                        1       2       3       4       5       6       7
  3868.         Priorities:  UNREAD   DATE  ------- ------- ------- ------- -------
  3869.  
  3870.         Un-Read Messages: FIRST [X]      Messages with Attachments: FIRST [ ]
  3871.         Priority [@|1|     LAST [ ]      Priority [@|0|              LAST [ ]
  3872.  
  3873.         Replied Messages: FIRST [ ]      Forwarded Messages: FIRST [ ]
  3874.         Priority [@|0|     LAST [ ]      Priority [@|0|       LAST [ ]
  3875.  
  3876.         Latest Date:      FIRST [X]      Largest Messages: FIRST [ ]
  3877.         Priority [@|2|     LAST [ ]      Priority [@|0|     LAST [ ]
  3878.  
  3879.         Group by FROM at Priority [@|0|    Group by Subject at Priority [@|0|
  3880.  
  3881.         [ ] Order Received
  3882.                            --> at Priority [@|0|     [ ] Apply to all Folders
  3883.         [ ] Latest Received
  3884.  
  3885.                   [ USE ]           [ SAVE ]           [CANCEL]
  3886.  
  3887.         =====================================================================
  3888.  
  3889.         When you are satisfied with the order click on [SAVE] to save
  3890.         this order for this folder only.  If you want to use this order
  3891.         for all your folders click on "Apply to all Folders" before
  3892.         clicking on [SAVE].
  3893.  
  3894.  
  3895.         Another example might have the messages displayed with unread
  3896.         messages first, followed by messages grouped by SUBJECT, and
  3897.         within the SUBJECT grouping, by the latest date received.  This,
  3898.         in effect, creates a message threading condition with like subjects
  3899.         grouped together.
  3900.  
  3901.         To create this sort condition, click on the Un-Read Messages: FIRST
  3902.         box and set it's priority to 1.  Then set the "Group by Subject
  3903.         at Priority" cycle gadget to 2.  Finally click on the
  3904.         Latest Date: FIRST box and set it's priority to 3.  The final
  3905.         sort window for this grouping would be:
  3906.  
  3907.         =====================================================================
  3908.  
  3909.                        1       2       3       4       5       6       7
  3910.         Priorities:  UNREAD SUBJECT   DATE  ------- ------- ------- -------
  3911.  
  3912.         Un-Read Messages: FIRST [X]      Messages with Attachments: FIRST [ ]
  3913.         Priority [@|1|     LAST [ ]      Priority [@|0|              LAST [ ]
  3914.  
  3915.         Replied Messages: FIRST [ ]      Forwarded Messages: FIRST [ ]
  3916.         Priority [@|0|     LAST [ ]      Priority [@|0|       LAST [ ]
  3917.  
  3918.         Latest Date:      FIRST [X]      Largest Messages: FIRST [ ]
  3919.         Priority [@|3|     LAST [ ]      Priority [@|0|     LAST [ ]
  3920.  
  3921.         Group by FROM at Priority [@|0|    Group by Subject at Priority [@|2|
  3922.  
  3923.         [ ] Order Received
  3924.                            --> at Priority [@|0|     [ ] Apply to all Folders
  3925.         [ ] Latest Received
  3926.  
  3927.                   [ USE ]           [ SAVE ]           [CANCEL]
  3928.  
  3929.         =====================================================================
  3930.  
  3931.         If you want the messages sorted by with the earlier messages first
  3932.         within the subject grouping, you would click on Latest Date: LAST
  3933.         rather than Latest Date: FIRST.
  3934.  
  3935.         Since the date sort is controlled by the local date and time that
  3936.         the message was SENT, you might want to use the Order Received or
  3937.         Latest Received instead of Latest Date.  Order Received will list
  3938.         the messages with the oldest received first, while Latest Received
  3939.         will list the messages with the newest received first.
  3940.  
  3941.         You, of course, can set different sort orders for different folders.
  3942.         In this case select the folder you want to change the sort order
  3943.         on and DON'T click on the "Apply to all Folders" checkmark gadget.
  3944.  
  3945.  
  3946.     Address Book Window
  3947.  
  3948.         The Address Book window will be displayed in the lower portion of
  3949.         the screen whenever you double click on the ADDRESS BOOK command
  3950.         icon or on the [Call Address Book] button in the COMPOSE MESSAGE
  3951.         window (see below under the COMPOSE MESSAGE window description).
  3952.  
  3953.         If you have a non-interlaced screen (640 x 200), the display will
  3954.         cover the folder strip to allow more room for the Address Book
  3955.         display.  With an interlaced screen (640 x 400) you will be able
  3956.         to see the folder strip.
  3957.  
  3958.         The Address Book window looks like the following:
  3959.  
  3960.         =====================================================================
  3961.         Address Book
  3962.         =====================================================================
  3963.  
  3964.         Nick Name: [        ] Address: [                   ] Select [@| To: |
  3965.  
  3966.         Real Name: [                        ] Group [ ]  Send Header Only [ ]
  3967.  
  3968.         Nickname Real Name                 UserID (Address)
  3969.         ---------------------------------------------------------------------
  3970.         xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  3971.         xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxx DISTRIBUTION LIST              | |
  3972.                                            xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  3973.                                            xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  3974.         ---------------------------------------------------------------------
  3975.  
  3976.           [ ADD ]     [MODIFY]      [DELETE]      [SELECT]      [ EDIT ]
  3977.  
  3978.         =====================================================================
  3979.  
  3980.         This window can be used to create, modify, or delete Address Book
  3981.         entries.  It can also be used to select a Nickname to be used
  3982.         as a recipient of a message when composing messages.
  3983.  
  3984.         Several of the Command icons remain active when you are displaying
  3985.         the Address Book window, although there meaning maybe slightly changed.
  3986.         These are the DISPLAY NEXT MESSAGE icon, the DISPLAY PREVIOUS MESSAGE
  3987.         icon, the PRINT icon, the DELETE icon, and the COMPOSE MESSAGE icon.
  3988.  
  3989.         The three fields of an address book entry are: a one to eight
  3990.         character Nickname, an individual's real name, and the address
  3991.         of the individual (UserId and Domain in the form userid@domain).
  3992.  
  3993.         Group lists can also be created which distributes a message to
  3994.         a number of different individuals.  The group is identified with
  3995.         the heading "DISTRIBUTION LIST" in the top most UserID field and
  3996.         the UserID's for the members of that list are shown in alphabetic
  3997.         order below that heading.  For items in the distribution list, real
  3998.         UserIDs or Nicknames can be used.  An item in the distribution list
  3999.         can even be another distribution list identified by the Nickname
  4000.         for that group. By clicking on the Checkmarked item "Group", you
  4001.         can identify the entry as a group item.
  4002.  
  4003.         The checkmarked item identified as "Send Header Only" is only
  4004.         active when "Group" is checked.  If a checkmark is in the "Send
  4005.         Header Only" box, only the group name will be sent in the To:
  4006.         field when a message is sent to the group; otherwise, every UserId
  4007.         in the group will be listed in the To: header.  It is a good idea
  4008.         to check this item if you have large groups or if you don't want
  4009.         the other members of the group to know all the members of the
  4010.         group.
  4011.  
  4012.         If a Nickname rather than a UserID is used in the group list Address
  4013.         field, then, if a modification is made to the UserID of the Nickname,
  4014.         you do not have to change the item in the Group list.  The modification
  4015.         will be automatic when the group rather than the individual is
  4016.         selected.
  4017.  
  4018.         When composing a message, a Nickname can be used to identify
  4019.         the recipient of a message.  All Nicknames are expanded to
  4020.         Real Name and UserID when mail is sent.
  4021.  
  4022.         Address Book entries are sorted by Nickname and group entries are
  4023.         interspersed with single entries.  Also Real Names are presented as
  4024.         first name followed by last name rather than last name, first name.
  4025.  
  4026.         For adding entries to the Address Book, the entries at the top
  4027.         of the window are used to place data in the various fields of the
  4028.         Address Book entry.  If a message was selected when the address
  4029.         book was called, the Real Name:, if present, and Address: fields are 
  4030.         filled in with information from the Reply-To: header of the message.  
  4031.         If the Reply-To: header is not present, the From: header will be used.
  4032.         You can force the From: header to be used by holding down the shift
  4033.         key when you click on the Address Book icon.
  4034.  
  4035.         If you access the Address Book from the Compose message window
  4036.         during a "mailto:" call to AEMail, the userid from the "mailto:" will
  4037.         be placed in the address field.  This allows you to assign a Nickname
  4038.         and Real Name to this address and save it in your Address Book.
  4039.  
  4040.         If you click on one of the entries in the list view, that entry will
  4041.         be transferred to the Nickname:, Real Name:, and Address: fields
  4042.         at the top of the window.  If you click on a group entry line which
  4043.         has the Group Nickname and "DISTRIBUTION LIST" in the address
  4044.         portion, only the Nickname: and the Group name (in the Real Name
  4045.         field) will be transferred leaving any previous address in the
  4046.         Address field.  The "Group" box will also be checked.  This facilitates
  4047.         adding items to a Group list.
  4048.  
  4049.         When adding an entry to the address book, you must always enter a
  4050.         Nickname and Address.  Real Name is optional, but recommended.
  4051.  
  4052.         To add a group entry, the "Group" box must be checked.  Groups
  4053.         need a Nickname and should have a group description entered in
  4054.         the Real Name: string gadget.  Group entries are entered one at
  4055.         a time.  The maximum number of entries that can be added to a
  4056.         group is 3000.  When a message is sent to a group, the message 
  4057.         will be sent to a maximum of 50 recipients at a time.  This takes
  4058.         care of problems when there is a limit on the number of 
  4059.         recipient addresses that a SMTP server can handle at a time.
  4060.  
  4061.         After correctly filling in the top portion of the window, click
  4062.         on the [ADD] button to add the item to the list.  Except for
  4063.         group Nicknames, there can't be a duplicate Nickname when
  4064.         adding to the list.  An already existing group Nickname will
  4065.         cause the entry to be added to that groups distribution list.
  4066.  
  4067.         To modify an entry, the Nickname must already exist in the list.
  4068.         You can not modify Nicknames.  If you need to do this, delete the
  4069.         old entry and add a new one.  For individual entries, you can modify
  4070.         either the Real Name: or Address: fields.  For group entries
  4071.         you can only modify the Real Name: field.  If you need to modify
  4072.         an address in the distribution list, delete the old one and add
  4073.         a new one.
  4074.  
  4075.         One of the reasons that Nicknames are preferred in distribution
  4076.         lists is that, if you need to modify a user's address,  you can do
  4077.         so by simply modifying the Individual's entry.  The address in the
  4078.         group is then automatically updated by reference.
  4079.  
  4080.         Selecting one of the entries in the address list will move the
  4081.         data from that entry to the fields at the top of the window.
  4082.         Make the modifications you want then click on the [MODIFY]
  4083.         button to make the modifications.
  4084.  
  4085.         To delete an entry, select it in the list and then click on
  4086.         the [DELETE] button.  You can also use the DELETE icon to do
  4087.         this.
  4088.  
  4089.         The [SELECT] button is used to select an address from the
  4090.         Address Book and place it in the appropriate recipients
  4091.         address line when composing messages.  To determine which
  4092.         header field is to receive the address, the "Select" cycle
  4093.         gadget at the top of the window is used.  There are three
  4094.         items for this gadget: To:, cc:, and bcc:.  Determine which
  4095.         field should receive the address and then click on the
  4096.         [SELECT] button.  The Nickname for the selected item is
  4097.         transferred to the appropriate field in the compose window.
  4098.  
  4099.         You can avoid using the [SELECT] button if the address book
  4100.         was called from the COMPOSE MESSAGE screen by double clicking
  4101.         on an item in the Address Book list view.
  4102.  
  4103.         If the Address Book was not called from the COMPOSE MESSAGE screen,
  4104.         instead of double clicking, the COMPOSE MESSAGE command icon can be
  4105.         selected when in the Address Book window.  When this is done, the
  4106.         COMPOSE MESSAGE window is activated for composing a new message and
  4107.         the [SELECT] button does not have to be clicked.
  4108.  
  4109.         The [EXIT] button is used to exit from the Address Book window
  4110.         without performing an address selection for a composed message.  You
  4111.         will need to [EXIT] from the Address Book if you want to quit
  4112.         AEMail.
  4113.  
  4114.         If the Address Book was called while displaying a message, clicking
  4115.         on the DISPLAY NEXT MESSAGE or the DISPLAY PREVIOUS MESSAGE icons
  4116.         will automatically exit from the Address Book and display either the
  4117.         next or previous message in the currently displayed message list.
  4118.  
  4119.         If the PRINT icon is selected while you are displaying the Address
  4120.         Book, you will get a printout of your complete address book.  All
  4121.         individual entries will be displayed first followed by group entries.
  4122.         Unless a group is too large to fit on one page, an attempt will be
  4123.         made to ensure that a group will be printed in it's entirety on a page.
  4124.  
  4125.         NOTE: When AEMAIL is loaded it will automatically create an address
  4126.         book entry for the Nickname AEMAIL with an address for my email
  4127.         address: jzachar@calweb.com.  You can use this entry whenever
  4128.         you wish to report a bug or send a message concerning AEMAIL to me.
  4129.  
  4130.  
  4131.     Message Display Window
  4132.  
  4133.         The Message Display window will be displayed in the lower portion of
  4134.         the screen whenever you double click on a message in the message
  4135.         list window.  If you are already displaying a message, clicking
  4136.         on the NEXT or PREVIOUS command icons will display either the NEXT
  4137.         or PREVIOUS message.
  4138.  
  4139.         If you have a non-interlaced screen (640 x 200), the display will
  4140.         cover the folder strip in allow more room for the message display.
  4141.         With an interlaced screen (640 x 400) you will be able to see and
  4142.         use the folder strip.
  4143.  
  4144.         The message is divided into two sections: message header information,
  4145.         which is always present, and a scrolling list that displays the message.
  4146.         Header information will also be displayed in the scrolling message
  4147.         listview, but only those header lines that you want displayed.
  4148.  
  4149.         The message header portion of the screen is set up as follows:
  4150.  
  4151.         From: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Date: DOW, MMM DD YYYY HH:MM:SS
  4152.         To: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx [ATTACHMENT]
  4153.         Subject: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  4154.  
  4155.  
  4156.         The From: and To: fields will show the Real Name (if present) from
  4157.         the appropriate header.  If the Real Name is not present in the
  4158.         header, then the UserID will be used instead.  If a Nickname is being
  4159.         used for a message being sent, then the Nickname will appear.
  4160.  
  4161.         The Subject field will have the RE; or (FWD) preappended to the
  4162.         field for messages that are REPLIES and/or are FORWARDED.
  4163.  
  4164.         If the message has attachments, either MIME or UUENCODED, the
  4165.         [ATTACHMENT] button will appear at the right of the To: line.
  4166.         If no attachments are present this button will not appear.
  4167.  
  4168.         The complete message will be displayed in the message listview
  4169.         including any text type attachments.  If the attachments are in
  4170.         BASE64 notation or are UUENCODED attachments, they will not be
  4171.         shown, but can be retrieved by clicking on the [ATTACHMENT] button.
  4172.         This will bring up an attachment requestor which is described below
  4173.         under "Attachment Requester".  Messages that are encoded with
  4174.         "Quoted-Printable" notation will be correctly displayed.
  4175.  
  4176.         While messages are loaded into the listview, you will not see them 
  4177.         until they are completely read.  A busy pointer will be displayed 
  4178.         until the listview is completely built.
  4179.  
  4180.     Attachment Requester
  4181.  
  4182.         When you click on the [ATTACHMENTS] button on the Message Display
  4183.         Window, an Attachment Requester will be displayed.  It looks like
  4184.         this:
  4185.  
  4186.         ============================================================
  4187.         [o]  Attachment List
  4188.         ============================================================
  4189.                         MimeType/SubType          File Name
  4190.          ==========================================================
  4191.          | 1  SHOWN     text/plain                              | |
  4192.          |    Description: (None)                               | |
  4193.          | 2  VIEWABLE  image/gif                 castle.gif    | |
  4194.          |    Description: Picture of a castle                  | |
  4195.          | 3  SAVE ONLY application/octet-stream  aemail.lha    | |
  4196.          |    Description: The AEMAIL archive                   | |
  4197.          ==========================================================
  4198.  
  4199.          [    VIEW   ]  [VIEW & SAVE]  [    SAVE   ]  [    EXIT   ]
  4200.         =============================================================
  4201.  
  4202.         This requester is initially placed at the top center of the window
  4203.         partially obscuring the command and folder icons and the top
  4204.         portion of the message.  You can drag the requester around the
  4205.         window to expose other items of the display.  You can also use
  4206.         the scroll bar on the message display listview to show different
  4207.         parts of the message; however, none of the commands on the
  4208.         command or folder bar or the menu bar can be activated until
  4209.         after you click on the [EXIT] button in the Attachment Requester.
  4210.  
  4211.         The SHOWN designation is used for any attachment that is displayed
  4212.         in the message window.  This is generally any attachment that has
  4213.         a MIME type of text or message.  However, standard Mailcap entries 
  4214.         have been included in the Mailcap file to also display and save
  4215.         these attachments from the Attachment window.
  4216.  
  4217.         Any message with attachments will generally have one section (the 
  4218.         initial message) which is displayable text and will be shown as an 
  4219.         attachment with the SHOWN designation.  You will also be able to
  4220.         VIEW all SHOWN parts of the message separably.
  4221.  
  4222.         UUENCODED attachments will have the designation UUENCODED displayed
  4223.         in the MIME types/subtypes field.
  4224.  
  4225.         Any attachments that do not have a MIME type of text or message
  4226.         will have either a VIEWABLE or SAVE ONLY designation.  The VIEWABLE
  4227.         designation is used for those MIME types/subtypes which have a
  4228.         program designated in the mailcap file for displaying this
  4229.         MIME type/subtype.  If no program is designated for this
  4230.         MIME type/subtype the SAVE ONLY designator will appear on the
  4231.         attachment line and the [VIEW] and the [VIEW & SAVE] buttons
  4232.         will be disabled.
  4233.  
  4234.         UUENCODED attachments are always SAVE ONLY attachments.
  4235.  
  4236.         To select an attachment to view, view & save, or to save only,
  4237.         select the appropriate attachment line in the list view gadget.
  4238.         You can select the main description line (with number, mime type,
  4239.         and filename) or the second line with the "Description:" heading.
  4240.  
  4241.         After selecting the attachment, the buttons below the listview will
  4242.         perform the following actions:
  4243.  
  4244.             [VIEW]
  4245.  
  4246.                 This will display the attachment with the program you
  4247.                 selected in the "mailcap" file for this MIME type/subtype.
  4248.                 If a program was not pre-defined for this MIME type/subtype
  4249.                 this button will be disabled and you will not be able to
  4250.                 display the attachment.  You will also see SAVE ONLY rather
  4251.                 than VIEWABLE on the description of this attachment.
  4252.  
  4253.             [VIEW & SAVE]
  4254.  
  4255.                 A file requester will pop up which allows you to select
  4256.                 a file to save your attachment to.  The default directory
  4257.                 designated to receive attachments is RAM:; however, you can
  4258.                 change this with the file requester or set a different
  4259.                 default with the Default Path Parameters display on the
  4260.                 Configuration screen.
  4261.  
  4262.                 If a file name was provided in either the Content-Type: or
  4263.                 Content-Disposition: headers, the file name will be shown
  4264.                 on the attachment description and will be pre-set as the
  4265.                 filename in the file requester.  You can, of course, change
  4266.                 this name if you wish.
  4267.  
  4268.                 After the file is saved, the attachment will be displayed
  4269.                 with the program you selected in the "mailcap" file.
  4270.  
  4271.                 If a program was not pre-defined for this MIME type/subtype
  4272.                 this button will be disabled and you will not be able to
  4273.                 display the attachment.  You will also see SAVE ONLY rather
  4274.                 than VIEWABLE on the description of this attachment.
  4275.  
  4276.  
  4277.             [SAVE]
  4278.  
  4279.                 A file requester will pop up which allows you to select
  4280.                 a file to save your attachment to.  The default directory
  4281.                 designated to receive attachments is RAM:; however, you can
  4282.                 change this with the file requester or set a different
  4283.                 default with the Default Path Parameters display on the
  4284.                 Configuration screen.
  4285.  
  4286.                 If a file name was provided in either the Content-Type: or
  4287.                 Content-Disposition: headers or with the UUENCODED "begin"
  4288.                 line, the file name will be shown on the attachment
  4289.                 description and will be pre-set as the default filename
  4290.                 in the file requester.  You can, of course, change this
  4291.                 name if you wish.
  4292.  
  4293.                 You will always be able to save any attachment even if it
  4294.                 is SHOWN and a filename is not specified.
  4295.  
  4296.             [EXIT]
  4297.  
  4298.                 After performing all the operations you wish for any
  4299.                 particular attachment, click on this button to remove
  4300.                 the Attachment Requester.  This requester also has a
  4301.                 CLOSE gadget which you can also use to exit from the
  4302.                 requester.
  4303.  
  4304.  
  4305.     Compose Message Window
  4306.  
  4307.         The Compose Message window is brought up whenever you click
  4308.         on the COMPOSE MESSAGE command icon or select the Compose...,
  4309.         Reply..., or Forward... sub-menus under the Messages menu.  If
  4310.         a message is selected when you click on the COMPOSE MESSAGE
  4311.         command icon it will act as a "Reply to this message" action.
  4312.  
  4313.         The Compose Message window will cover the entire screen.  You
  4314.         must proceed sequentional through the actions or cancel to
  4315.         abort the compose operation.
  4316.  
  4317.         The Compose Message window looks like this:
  4318.  
  4319.         =====================================================================
  4320.                                       TITLE
  4321.         =====================================================================
  4322.  
  4323.                To: [                              ][CLR] [Call Address Book ]
  4324.  
  4325.                cc: [                                                   ][CLR]
  4326.  
  4327.               bcc: [                                                   ][CLR]
  4328.  
  4329.          Reply To: [                                   ][CLR] [ Use Default ]
  4330.  
  4331.           Subject: [                                                   ][CLR]
  4332.  
  4333.                    [ ] Quote Original Message Text   Quote Prefix[>         ]
  4334.  
  4335.                    Quote Header: [                                          ]
  4336.  
  4337.                    [ ] Add Signature Block                [Edit Signature   ]
  4338.  
  4339.                                  [Add Attachments]
  4340.  
  4341.              [New Msg]     [ Edit ]    [ Reply]    [Forward]     [Cancel]
  4342.  
  4343.         ======================================================================
  4344.  
  4345.         The TITLE that appears on the Compose Message window will be one of
  4346.         the following:
  4347.  
  4348.                             Compose a new Message
  4349.                               Reply to a Message
  4350.                                Forward Message
  4351.                                 Edit Message
  4352.  
  4353.         Which title appears depends on the way the Compose Message window
  4354.         was called.
  4355.  
  4356.         "Edit Messages" appears if a message was selected from the PENDING 
  4357.         or QUEUED folders and the COMPOSE MESSAGE command icon was selected 
  4358.         or the "Edit..." menu item was selected from the Messages menu.
  4359.  
  4360.         "Reply to a Message" appears if a message was selected from an input 
  4361.         folder (such as INBOX) and the COMPOSE MESSAGE command icon was 
  4362.         selected or the "Reply..." menu item was selected from the Messages 
  4363.         menu.
  4364.  
  4365.         "Forward Messages" appears if a message was selected and the 
  4366.         "Forward..." menu item was selected from the Messages menu.
  4367.  
  4368.         "Compose a new Message" appears if no message was selected, if 
  4369.         the "Compose.." menu item was selected, or if a message in the 
  4370.         SENT folder was selected.
  4371.  
  4372.         "Compose a new Message" also appears if the Compose message window
  4373.         was activated by a "mailto:" call from a browser.
  4374.  
  4375.         If the "Edit...", "Reply..." or "Forward..." menu items are selected
  4376.         and a message was not selected, an error message appears.  If the
  4377.         "Compose..." sub-menu is selected, a new message will always be
  4378.         created.  Likewise, messages cannot be replied to or forwarded from
  4379.         the PENDING, QUEUED or SENT folders.  If the "Edit..." menu item is
  4380.         selected, the message must come from either the PENDING or QUEUED
  4381.         folder.
  4382.  
  4383.         The [Edit], [Reply], and [Forward] buttons will be ghosted except
  4384.         when the appropriate action is available to be performed as indicated
  4385.         by the window title.  [New Msg] will never be ghosted which gives the
  4386.         ability to create a new message at any time.
  4387.  
  4388.         When the Compose window first appears, if the message is a replied
  4389.         or forwarded message, the Subject: string gadget will be automatically
  4390.         filled in with the subject from the replied or forwarded message.
  4391.         RE: or (fwd) will also automatically appear in front of the subject.
  4392.  
  4393.         If the message is a replied message, the To: string gadget will 
  4394.         also be filled in with the Reply-To: address from the message you 
  4395.         are replying to or, if that is not present, the From: real name and 
  4396.         user ID of the message you are replying to.
  4397.  
  4398.         Also, if the message is the result of a "mailto:" call, the To: string
  4399.         gadget will be filled in with the userid passed by the "mailto:" call.
  4400.  
  4401.         You may enter names, either Nicknames or Real Names and/or UserIDs,
  4402.         for any of the To:, cc:, or bcc: fields.  If a Real Name and/or
  4403.         UserID is entered, it should be entered as
  4404.  
  4405.                 Real Name<userid@domain>              or
  4406.                 userid@domain(Real Name)              or
  4407.                 userid@domain
  4408.  
  4409.         The domain can be left off if the recipient is at the same domain as
  4410.         the user.
  4411.  
  4412.         If a Nickname is used it will be automatically expanded when the
  4413.         message is sent.
  4414.  
  4415.         If multiple users are placed in any of the To:, cc:, or bcc: fields
  4416.         they must be separated by commas.
  4417.  
  4418.         If the users you are sending the message to are in your Address
  4419.         Book, you can click on the [Call Address Book] button.  This will
  4420.         call up your Address Book and you can select the user you want.
  4421.         Be sure and set the Select: cycle gadget to the appropriate
  4422.         field you want the name to be added to (To:, cc: or bcc:) and
  4423.         click on the [Select] gadget.  The Nickname for the user will be
  4424.         automatically added to the appropriate field in the Compose
  4425.         window.  If you make a mistake and the wrong name is added or
  4426.         it is added to the wrong field, you can use the backspace key
  4427.         to remove the offending nickname or the [CLR] gadget to completely
  4428.         clear the field.
  4429.  
  4430.         You can [Call Address Book] as many times as you want and the
  4431.         Nicknames will be added to the appropriate fields.  Multiple
  4432.         names in any field will be automatically separated by commas
  4433.         if this method is used for adding names to the fields.
  4434.  
  4435.         You can also use the [Call Address Book] gadget to place the userid
  4436.         from a "mailto:" call into your Address Book.
  4437.  
  4438.         The cc: field is used to send a "carbon copy" of the message
  4439.         to the people in the list on the cc: line.  The cc: header will
  4440.         appear on the message sent to the To:, cc: and bcc: recipients.
  4441.         The bcc: field is used the send a "blank carbon copy" to the
  4442.         people in that list.  The bcc: recipients will not be identified
  4443.         for any of the receipients of the message.
  4444.  
  4445.         The Reply To: field is used to place a Reply-To: address header 
  4446.         in the message.  This field is intended for people who want replies
  4447.         directed to a different email address than their From: address.  The
  4448.         configuration item "Reply-To:" will automatically be loaded into
  4449.         this field when the compose screen is displayed.  If the Reply To:
  4450.         address for this message should be different than the configured
  4451.         Reply-To address, then place it here.  If you click on the 
  4452.         [ Use Default ] button, your configured Reply-To address will
  4453.         be placed is this field.  If the Reply To: field is left blank, 
  4454.         no Reply-To: header line will be added to the message.
  4455.  
  4456.         The [CLR] gadget to the right of the To:, Reply To:, Subject:,
  4457.         cc:, and bcc: string gadgets allows you to easily clear the
  4458.         data in the appropriate string gadget.
  4459.  
  4460.         If the message is a reply, the "Quote Original Message Text" box
  4461.         will be checked if you have selected this option in the Configuration
  4462.         screen.  You can un-check this box if you don't want the original
  4463.         text quoted in the message (or check it, if the default action
  4464.         was not to include text).  For all other types of Compose windows,
  4465.         this checkbox will be disabled.
  4466.  
  4467.         The "Quote Prefix:" string gadget will indicate what is to
  4468.         be placed in front of each quoted line.  This, by default, is
  4469.         '>'; however, you can add whatever you like here (such as
  4470.         the person's initials followed by : or >).  You can also
  4471.         permanently change this field with the General Parameters
  4472.         page of the Configuration screen.
  4473.  
  4474.         A "Quote header:" will be placed on the line in front of the quoted
  4475.         material.  Currently, the default header which will appear in the
  4476.         Quote Header: string gadget is:
  4477.  
  4478.             On &(week), &(date2), at &(time), &(name) wrote:
  4479.  
  4480.         The & followed by a field name in parenthesis indicates substitution
  4481.         of data from the original message.  The values that can be
  4482.         substituted are:
  4483.  
  4484.             &(name)     The Real Name of the sender of the original
  4485.                         message.  If the Real Name is not available,
  4486.                         the sender's UserId will be used instead
  4487.  
  4488.             &(subject)  The subject from the original message.  Any RE:
  4489.                         or (fwd) will be stripped.
  4490.  
  4491.             &(week)     The day of the week that the original message
  4492.                         was sent.
  4493.  
  4494.             &(date)     The date the original message was sent in the form
  4495.                         DD MMM YYYY, where DD is the day of the month,
  4496.                         MMM is month in the form Jan, Feb, Mar, etc, and
  4497.                         YYYY is the full 4 digit year.
  4498.  
  4499.             &(date1)    Same as &(date).
  4500.  
  4501.             &(date2)    The date in the form MMM DD, YYYY.
  4502.  
  4503.             &(time)     The time the original message was sent in the
  4504.                         form HH:MM xM where HH is the hour on a 12 hour
  4505.                         clock, MM is the minute, and xM is AM or PM.
  4506.  
  4507.         The "Quote Header" is designed to be modified by the user and
  4508.         can be changed with the string gadget.  This change is only in
  4509.         effect for this message, however.  You can permanently change the
  4510.         "Quote Header" with the General Parameters section of the
  4511.         Configuration screen.
  4512.  
  4513.         If a .signature file is present, the "Add Signature Block" box
  4514.         will be checked.  If the .signature file is not present, this
  4515.         checkbox will be disabled.  If you want to create or edit the
  4516.         .signature file, you can click on the [Edit Signature] button.
  4517.         This will call up your editor to allow you to create or edit
  4518.         the .signature file.  After you have edited or created your
  4519.         signature file in your editor, save the file and exit from the
  4520.         editor.  This will return you to the COMPOSE MESSAGE window
  4521.         and the "Add Signature Block" check box will now be enabled.
  4522.  
  4523.         If you do not want the signature block placed at the end of your
  4524.         message, uncheck the Add Signature Block box.
  4525.  
  4526.         Note: if the message is being edited, the Add Signature Block
  4527.         box WILL NOT be checked.  This is done to prevent two signature
  4528.         blocks being added to the message.  However, rather than disable
  4529.         this item, it is left to allow the user to add a signature block
  4530.         in the event one was not added to the original message or you
  4531.         selected [NEW] in the compose window.
  4532.  
  4533.         The [Add Attachments] botton brings up the Add Attachments Requster
  4534.         which is described below.  This requester allows you to add one or
  4535.         multiple files as attachments to your message.  You can bring up
  4536.         this requester at any time.  If it is brought up a second time, the
  4537.         old attachment information will appear in the attachment list.  You
  4538.         can add to this information or delete entries as you desire.
  4539.  
  4540.         If you decide that you do not want to compose a message after
  4541.         all, click on the [CANCEL] button to exit the COMPOSE MESSAGE
  4542.         window.
  4543.  
  4544.         Otherwise, if all the correct information has been added in the
  4545.         COMPOSE MESSAGE window, click on the appropriate action button
  4546.         at the bottom of the window.  [New Msg] will create a new message.
  4547.         You can also use one of the other buttons: [Edit], [Reply], or
  4548.         [Forward] if it is not ghosted.  All but the [Forward] button will
  4549.         call up your editor to allow you to compose your message. [Forward]
  4550.         will forward the selected message to the indicated recipients without
  4551.         calling up the editor.
  4552.  
  4553.         Special NOTE for edited messages:  If the message you were editing
  4554.         had attachments, you must re-add these attachments BEFORE exiting
  4555.         from the COMPOSE MESSAGE window.  Of course, if you forgot to add
  4556.         the attachments the first time, you can add them by editing the
  4557.         message.
  4558.  
  4559.         In your editor window you will see the message header, which has been
  4560.         constructed from the COMPOSE MESSAGE window information followed by
  4561.         any quoted material and then your signature block (if requested). You
  4562.         can delete any material you wish from the quoted text and/or insert
  4563.         lines between quoted text.
  4564.  
  4565.         Whether on not the quoted messages header is to be included in
  4566.         the quote is controlled by the "Incl Hdr in Resp" submenu item
  4567.         under the Messages main menu group.  If this item is checked the
  4568.         "Date", "To", "From:", "Reply To:", "Subject:", "cc:", and "bcc:"
  4569.         headers will be displayed from the original message.  If it is
  4570.         not checked, no header information will be included.
  4571.  
  4572.         The amount of header information in the quoted message is also
  4573.         controlled by the "Display Full Hdr" menu item in the Messages
  4574.         menu.
  4575.  
  4576.         WARNING: when you start entering you message information, you must
  4577.         insure that one blank line follows the message header.
  4578.  
  4579.         Special note for users of CED (CygnusEd Professional):  In order
  4580.         for attachments to be properly added to messages, your editor can
  4581.         not relenquish control until you have finished editing the message.
  4582.         The normal execution of CED will relenquish control.
  4583.  
  4584.         To correct this problem, a special script has been provided for
  4585.         CED users which will prevent CED from relenquishing control.
  4586.         This script, called "AEMced.scr"  should be placed in your s:
  4587.         directory and called with "s:AEMced.scr %s".  If you configure
  4588.         AEMail when you perform the install, this will be done automatically
  4589.         if you specify CED as your editor.
  4590.  
  4591.         Other editors that have been used successfully with AEMAIL have been 
  4592.         the AmigaDos editors Ed and Memacs.
  4593.  
  4594.         A future version of this documentation will give some tricks and tips
  4595.         for using various various editors with AEMAIL.
  4596.  
  4597.  
  4598.     Add Attachments Requester
  4599.  
  4600.         When you click on the [ADD ATTACHMENTS] button on the Compose
  4601.         Message Window, an Add Attachments Requester will be displayed
  4602.         which looks like this:
  4603.  
  4604.         =============================================================
  4605.         [o]  Add Attachments
  4606.         =============================================================
  4607.  
  4608.                       Filename: [                              ][REQ]
  4609.         Attachment Description: [                                   ]
  4610.           Content Type/SubType: [                                   ]
  4611.                                 =====================================
  4612.                                 | text/plain                      | |
  4613.                                 | text/enriched                   | |
  4614.                                 | text/richtext                   | |
  4615.                                 =====================================
  4616.                       Encoding: |@|           Plain Text            |
  4617.  
  4618.          Mime Type/Sub-Type   FileName                 Encoding
  4619.         =============================================================
  4620.         |                                                         | |
  4621.         |                                                         | |
  4622.         |                                                         | |
  4623.         |                                                         | |
  4624.         =============================================================
  4625.         [  ADD ]         [DELETE]         [ APPLY ]         [CANCEL ]
  4626.  
  4627.         =============================================================
  4628.  
  4629.         The Filename string gadget should contain the FULL path name and
  4630.         filename of the attachment.  Clicking on the [REQ] gadget will
  4631.         bring up a file requester which will allow you to select the
  4632.         appropriate file.  The filename portion of this string will be
  4633.         used as the "file=" parameter of the Content-Type MIME header and
  4634.         as the "filename=" parameter of the Content-Disposition MIME
  4635.         header.
  4636.  
  4637.         The initial directory that is chosen for the file requester is the
  4638.         directory that was set up in the "Add Attachment from Directory"
  4639.         string gadget in the Configuration: Default Path Parameters (see
  4640.         Configuration Screen under IV. Configuration above).  If you are
  4641.         adding multiple attachments to the message, clicking on [REQ] will
  4642.         bring up the last directory that you used.
  4643.  
  4644.         The Attachment Description is an optional string gadget for entering
  4645.         a description of the attachment.  If present, this string gadget will
  4646.         create a Content-Description MIME header.
  4647.  
  4648.         Content Type/SubType is a string gadget which contains the MIME
  4649.         Content Type/Subtype entry which will appear on the Content-Type
  4650.         MIME header.  THIS IS A REQUIRED ENTRY UNLESS YOU ARE ADDING AN
  4651.         UUENCODED attachment.  It is not used for UUENCODED attachments.
  4652.  
  4653.         A scrolling list below this gadget is used to select an appropriate
  4654.         type/sub-type.  Predefined type/subtypes, as defined in RFC 1341 and
  4655.         RFC 1521, are included in this list as follows:
  4656.  
  4657.             text/plain
  4658.             text/enriched
  4659.             text/richtext
  4660.             message/rfc822
  4661.             message/partial
  4662.             message/external-body
  4663.             multipart/mixed
  4664.             multipart/alternative
  4665.             multipart/digest
  4666.             multipart/parallel
  4667.             application/octet-stream
  4668.             application/postscript
  4669.             image/gif
  4670.             image/jpeg
  4671.             audio/basic
  4672.             video/mpeg
  4673.  
  4674.         Also added to this list will be any additional type/subtypes added
  4675.         through the mailcap file and any type/subtypes encountered when
  4676.         displaying attachments during THIS RUN OF AEMAIL.  AEMAIL has no way
  4677.         to remember differing type/subtypes that it encounters unless they
  4678.         are included in the mailcap file.
  4679.  
  4680.         You can also add your own type/subtype by directly entering it in
  4681.         the Content Type/SubType string gadget.  Unless the type/subtype
  4682.         is well known and published, you should pick one of the existing
  4683.         types (text/, message/, application/, image/, audio/, or video/)
  4684.         and use a subtype beginning with "x-".  As an example, you might
  4685.         want to define an IFF image (not part of the mime published
  4686.         standard) as:
  4687.  
  4688.             image/x-iff
  4689.  
  4690.         It is suggested that you use a mailcap entry for the image/x-iff
  4691.         to cause it to permanently appear in the list of Content Type/Subtypes.
  4692.         Attachments must be in the format you select.  AEMAIL will do no
  4693.         conversion.  As an example, if you select application/postscript,
  4694.         the file you attach should already be in postscript format.
  4695.  
  4696.         Also, DO NOT use the follwing types/subtypes:
  4697.  
  4698.             message/partial
  4699.             message/external-body
  4700.             multipart/mixed
  4701.             multipart/alternative
  4702.             multipart/digest
  4703.             multipart/parallel
  4704.  
  4705.         All of the multipart types are not supported except at the
  4706.         highest level (specifying the initial attachment list), and
  4707.         this is done automatically by the program.
  4708.  
  4709.         The encoding cycle gadget has four states as follows:
  4710.  
  4711.             Plain Text
  4712.             Quoted-Printable
  4713.             Encoded Binary
  4714.             UUENCODED
  4715.  
  4716.         Currently only the "Quoted-Printable" state is not effective.
  4717.         "Quoted-Printable" will be treated as "Plain Text".  While AEMAIL
  4718.         can handle retrieved messages that are in "Quoted-Printable" format,
  4719.         it does not convert mail and or attachments to that encoding format
  4720.         at this time.
  4721.  
  4722.         Generally speaking "Encoded Binary" should be used for the following
  4723.         types:
  4724.  
  4725.             application/
  4726.             image/
  4727.             audio/
  4728.             video/
  4729.  
  4730.         "Plain Text" should be used for:
  4731.  
  4732.             text/
  4733.             message/
  4734.  
  4735.         "UUENCODED" should be selected if you want the attachment to be in
  4736.         UUENCODED format.  You can not mix UUENCODED attachments with MIME
  4737.         attachments!
  4738.  
  4739.         When a type/subtype is selected, the appropriate encoding format
  4740.         is automatically selected.  Of course, you can change this with
  4741.         the cycle gadget if there is a need.
  4742.  
  4743.         Once all of the attributes for any particular attachment are selected,
  4744.         click on the [ADD] gadget to add the attachment to the attachment
  4745.         list.  If the Filename field or Content Type/Subtype field (other than
  4746.         for UUENCODED attachments) is blank an error requester will appear
  4747.         indicating that you must have a valid entry in these fields.  As many
  4748.         attachments as you want can be added to this list, but you can not
  4749.         mix MIME type attachments with UUENCODED attachments.
  4750.  
  4751.         If you wish to delete any particular gadget, select the attachment
  4752.         from the list and click on [DELETE].  There is no way to modify
  4753.         attachment attributes once they have been added to the list.  If
  4754.         you want to do this, first click on [DELETE], make the appropriate
  4755.         changes, and then click on [ADD].
  4756.  
  4757.         Once you are satisfied with your attachment list click on [APPLY].
  4758.         The Add Attachments Requester will disappear and the attachments
  4759.         will be automatically added to your message after it is composed.
  4760.  
  4761.         If you decide that you don't want to add attachments after all,
  4762.         click on [CANCEL] and the attachments will not be added when you
  4763.         compose your message.
  4764.  
  4765.         Clicking on the Close Gadget at the top of the window has the same
  4766.         effect as if you clicked on [CANCEL].
  4767.  
  4768.  
  4769. IX. AEMAIL FILES
  4770.  
  4771. The following are the various files used by AEMAIL.  They all reside in
  4772. the AEMAIL: directory with the exception of the aemail.cnfg file, the TCPLOG
  4773. file and the mailcap file.  The aemail.cnfg file resides in the S: directory,
  4774. and both the TCPLOG file and the mailcap file may or may not reside in the
  4775. AEMAIL: directory depending on the user's preference.
  4776.  
  4777. With the exception of the mailcap file, you can begin AEMAIL without any of
  4778. the other files being present.  They will be automatically created as you
  4779. process messages or do other AEMAIL actions.
  4780.  
  4781. The mailcap file, if used, MUST be setup prior to executing AEMAIL.  This
  4782. can be done using any text editor.
  4783.  
  4784. The following are the AEMAIL files:
  4785.  
  4786.     mailcap
  4787.  
  4788.         The mailcap file is used to establish programs that should be
  4789.         executed to display MIME attachments.  Use of this file allows
  4790.         AEMAIL to use any AmigaDOS operating system 2.1 or above.
  4791.  
  4792.         The mailcap file is a standard Internet file which is specified
  4793.         in RFC (Request For Comment) 1524.  Since it is standard, you can
  4794.         use a mailcap file that was created for another program that
  4795.         specified a display program for the same type of files.  That is
  4796.         the reason that AEMAIL allows you to specify the directory that
  4797.         contains the mailcap file with the Tool Type MAILCAP_DIR= or with
  4798.         the Configuration Screen.  If you do not include this Tool Type or
  4799.         change the specification in the Default Path section of the
  4800.         Configuration Screen, the mailcap directory will default to the
  4801.         AEMAIL: directory.
  4802.  
  4803.         AEMAIL only uses the two required fields of the RFC 1524 standard.
  4804.         Other fields are ignored at this time.
  4805.  
  4806.         Each mailcap file consists of entries that describe the proper
  4807.         handling of one media type at the local site.  A mailcap file
  4808.         consists of a sequence of such individual entries separated by
  4809.         LINE FEEDS.  Blank lines and lines starting with '#' are
  4810.         considered comments and are ignored.  Long entries may be
  4811.         continued on multiple lines if the line to be continued ends
  4812.         with a backslash character ('\').  In this event, mutiple lines
  4813.         are to treated as a single mailcap entry.  Note that for such
  4814.         "continued" lines, the backslash must be the last character of
  4815.         the line to be continued.
  4816.  
  4817.         Each mailcap entry consists of a number of fields each separated
  4818.         by a semicolon (';').  The first two fields are required, and
  4819.         must occur in the specified order.  The remaining fields are
  4820.         optional and may appear in any order.  NOTE: At this time AEMAIL
  4821.         does not use these optional fields and if they are present, ignores
  4822.         them.  Because of this, these optional fields WILL NOT be discussed
  4823.         in this documentation.
  4824.  
  4825.         The general format of a mailcap entry is:
  4826.  
  4827.             content type; view command [; ......] LINE FEED
  4828.  
  4829.         The first field is the content type, which indicates the type of
  4830.         data this mailcap entry describes how to handle.  It is to be
  4831.         matched against the type/subtype specification in the "Content-Type"
  4832.         MIME header (see the ADD ATTACHMENTS REQUESTER described in section
  4833.         VIII. AEMAIL WINDOWS above).
  4834.  
  4835.         If the subtype is "*", it is intended to match all subtypes of the
  4836.         named content type.
  4837.  
  4838.         Examples of the content type field are:
  4839.  
  4840.             images/gif
  4841.  
  4842.         which is intended to match only the images/gif type/subtype whereas
  4843.  
  4844.             images/*
  4845.  
  4846.         matches all image types (images/gif, images/jpeg, etc).
  4847.  
  4848.         The second field, view command, is a specification of how the
  4849.         attachment meeting the content type specification is viewed.
  4850.         For any particular operating system, this would indicate how
  4851.         the program is called.  For AEMAIL this would include the entire
  4852.         path name for calling the program and any parameters that are
  4853.         needed on the command line.  A "%s" is used to indicate the
  4854.         substitution of the attachment name.  The entire entry should
  4855.         be surrounded by quotes.  As an example:
  4856.  
  4857.             "sys:Utilities/multiview %s screen"
  4858.  
  4859.         would call multiview placing the displayed attachment on its
  4860.         own screen (the "screen" parameter).
  4861.  
  4862.         If you needed to have the display on the Workbench screen you
  4863.         can add the keyword "wb;" in front of the program path.  As an
  4864.         example, if you wanted multiview to open on a window on the
  4865.         Workbench screen, you could use:
  4866.  
  4867.             "wb;sys:Utilities/multiview %s"
  4868.  
  4869.         Note the use of the quotes (") surrounding the parameter.  This is
  4870.         necessary so that the mailcap interpreter will be prevented from
  4871.         treating special characters (such as ';') as part of the mailcap
  4872.         syntax.
  4873.  
  4874.         Also note the absence of the "screen" keyword.  The above call
  4875.         would push the Workbench screen to the front when MultiView was
  4876.         called and the Workbench screen would be used for the MultiView
  4877.         window.  The only problem with this is you would be limited to
  4878.         the number of colors and the resolution specified for Workbench.
  4879.         Some other programs, however, might only be able to open as a
  4880.         window on the Workbench screen and would be hidden by the AEMAIL
  4881.         screen when those programs were called unless the "wb;" parameter
  4882.         was specified.
  4883.  
  4884.         An example of a complete mailcap entry to use multiview to display
  4885.         all images would be:
  4886.  
  4887.             image/*; "sys:Utilities/multiview %s screen"
  4888.  
  4889.         Any image/ type, regardless of the subtype, would be displayed
  4890.         providing there was an appropriate data type present for that
  4891.         image subtype.
  4892.  
  4893.         A sample mailcap file is included with the archive which uses
  4894.         MultiView for text, message, sound, image, and video files.  Since 
  4895.         MultiView is a 3.x program using datatypes, this mailcap file will 
  4896.         ONLY work with 3.x systems.  To make it work for 2.x systems, you
  4897.         would need to change the display programs to your favorite
  4898.         programs that work with 2.x.  You might also have to be specific
  4899.         as to the subtype for a specific display type/subtype.  If you
  4900.         install AEMAIL on a 2.1 system using the provided installation
  4901.         script, you will be able to create the mailcap file provided you
  4902.         selected "Expert" mode for the installation "user mode".
  4903.  
  4904.         The following is the sample mailcap file used for AmigaDos 3.x that
  4905.         uses MultiView as the display agent.  Please note the use of the
  4906.         "screen" parameter which tells MultiView to open on it's own screen
  4907.         rather than the WorkBench screen.  This allows the use of all colors
  4908.         in the image's palette.
  4909.  
  4910.             text/*;  "sys:Utilities/multiview %s"
  4911.             message/*; "sys:Utilities/Multiview %s"
  4912.             image/*; "sys:Utilities/multiview %s screen"
  4913.             audio/*; "sys:Utilities/multiview %s screen"
  4914.             video/*; "sys:Utilities/multiview %s screen"
  4915.  
  4916.  
  4917.     General Config File (aemail.cnfg)
  4918.  
  4919.         The s:aemail.cnfg file is the General Configuration file.  This file 
  4920.         contains various configuration information including the version and 
  4921.         revision number of the AEMail version that was last loaded.  A special 
  4922.         flag in this file indicates whether this file should take precedence 
  4923.         over the Tool Type entries.
  4924.  
  4925.         This file is normally placed in the S: directory rather than the AEMAIL:
  4926.         directory.  The reason for this was that if you changed the
  4927.         location of the AEMAIL: directory, AEMAIL would not be able to
  4928.         locate the new configuration file the next time you loaded AEMAIL.
  4929.         Also, the S: directory is more commonly used to store configuration
  4930.         files for AMIGA programs.
  4931.  
  4932.         You do not have to store this file in the S: directory nor do you have
  4933.         to name it "aemail.cnfg".  This is only the default name and location
  4934.         for this file.  With the use of the CONFIG= Tool Type or the config=
  4935.         parameter on the shell call for AEMail, you can rename the file and
  4936.         place it anywhere you want.
  4937.  
  4938.         With AEMail version 1.13 you can also have multiple configuration
  4939.         files.  This allows you to set up multiple configurations for 
  4940.         different users of AEMail.  You can select which configuration
  4941.         you want through the "Project/Configuration/Open" menu item.
  4942.  
  4943.         If the configuration is never changed with the Configuration Screen,
  4944.         the Tool Type entries will take precedence. If either the [SAVE] or
  4945.         [SAVE TO] gadgets in the Configuration Screen is selected, or the
  4946.         "Project/Configuration/Save" or "Project/Configuration/Save to" menu
  4947.         items are selected, the General Configuration File will always take 
  4948.         precedence.
  4949.  
  4950.         The s:aemail.cnfg (or CONFIG= Tool Type or config= shell parameter)
  4951.         is referred as your base configuration file.  You can always return
  4952.         to the base configuration through the "Project/Configuration/Restore
  4953.         Default" menu item.
  4954.  
  4955.         If you display the AEMail General Configuration file with a text editor, 
  4956.         you will find that not all portions of the file are readable as text.  
  4957.         The only way you can create and update the general configuration
  4958.         file is through AEMail itself.
  4959.  
  4960.         As part of this file is your password stored in encrypted format.
  4961.  
  4962.  
  4963.     .headers
  4964.  
  4965.         The .headers file provides a list of message headers.  Those that
  4966.         you want displayed in the message as "minimum headers" are preceded
  4967.         by an asterick (*); all other headers are preceded by a space.
  4968.  
  4969.         The .headers file may not be present.  If it is not, the following
  4970.         are displayed as the "minimum headers":
  4971.  
  4972.             Date:
  4973.             From:
  4974.             To:
  4975.             cc:
  4976.             bcc:
  4977.             Subject:
  4978.  
  4979.         See the discussion on configuring minimum headers in the General
  4980.         Parameters section of the Configuration Screen.
  4981.  
  4982.  
  4983.     folder.config
  4984.  
  4985.         This file gives the general information about each of the folders
  4986.         including:
  4987.  
  4988.             Flags (long word, 4 bytes): general flags concerning this folder
  4989.             Name (9 bytes including ending NULL): short folder name
  4990.             Pen (1 byte): pen number for folder tab
  4991.             Sort Keys (8 bytes): the permanent sort keys for the folder
  4992.             Folder Description (string ending in LINE FEED): the folder
  4993.                 description.  If this is a folder for one of the pre-set
  4994.                 folders, this string will be empty (LINE FEED only) unless
  4995.                 the user has decided to change the folder description.
  4996.             From Filter (string ending in LINE FEED): NOT IMPLEMENTED AS YET
  4997.             Subject Filter (string ending in LINE FEED): NOT IMPLEMENTED AS YET
  4998.             Date Filter (string ending in LINE FEED): NOT IMPLEMENTED AS YET
  4999.  
  5000.         For those fields that are strings: if the field is empty there will
  5001.         be a LINE FEED with no data preceding it.
  5002.  
  5003.         NOTE: if for some reason your folder.config file becomes corrupted
  5004.         or is accidently deleted, you can restore all of the folders and
  5005.         the messages within them by doing the following:
  5006.  
  5007.             delete any current folder.config file (or rename it so it is
  5008.                 no longer recognized).
  5009.             Run AEMAIL.  Add any additional folders that you previously
  5010.                 had added.  (INBOX, PENDING, QUEUED and SENT will automatically
  5011.                 be created).  You must use the exact name you had previously
  5012.                 used.
  5013.             The new folders will show 0 messages.
  5014.             Quit AEMAIL.
  5015.             Re-Run AEMAIL.  The new folders should now show the appropriate
  5016.                 number of messages provided a valid [folder_Name].config
  5017.                 file was present for that folder.  The name of the new
  5018.                 folder must exactly match the [folder_Name] in the
  5019.                 [folder_Name].config file.
  5020.  
  5021.  
  5022.     [folder_Name].config
  5023.  
  5024.         For each of the folders that contain messages there will be a
  5025.         configuration file which gives information on the messages in
  5026.         that folder.  The name of the file will be the short folder name
  5027.         with ".config" appended to it.
  5028.  
  5029.         For this version of AEMAIL, the [folder_Name].config file contains
  5030.         the following information for each message in the folder:
  5031.  
  5032.             Message Flags (word, 2 bytes): Flags describing the message.
  5033.             File Code (long word, 4 bytes): this field is a binary field
  5034.                 which is used to derive the file name for the message file
  5035.                 itself.
  5036.             Message Size (long word, 4 bytes): size of message.
  5037.             Body Displacement (word, 2 bytes): the position where the
  5038.                 body of the message starts.
  5039.             From (string ending in LINE FEED): the information in the
  5040.                 From: field in the message header.
  5041.             Subject (string ending in LINE FEED): the information in the
  5042.                 Subject: field in the message header.  The RE: and FWD:
  5043.                 headings at the beginning of the Subject header are
  5044.                 stripped, but indicated by flags in the Message Flags field
  5045.                 so that the exact subject field can be reconstructed.
  5046.             Date (string ending in LINE FEED): the information in the
  5047.                 Date: field in the message header.
  5048.             To (string ending in LINE FEED): the information in the
  5049.                 To: field in the message header.
  5050.             Return To (string ending in LINE FEED): the information in the
  5051.                 Return To: field in the message header.
  5052.             cc (string ending in LINE FEED): the information in the
  5053.                 cc: field in the message header.
  5054.             bcc (string ending in LINE FEED): the information in the
  5055.                 bcc: field in the message header.
  5056.  
  5057.         For those fields that are strings: if the field is empty, there
  5058.         will be a LINE FEED without any data preceding it.
  5059.  
  5060.  
  5061.     .addrbook
  5062.  
  5063.         This file provides address book information.  Each record looks
  5064.         like this:
  5065.  
  5066.             Count (word, 2 bytes): If this field is zero, the entry is
  5067.                 a single user entry.  If this field is greater that zero
  5068.                 it represents a group entry and indicates the number of
  5069.                 UserIds in the group.
  5070.             Nickname (string ending in LINE FEED): the Nickname for this
  5071.                 entry (both group or user).
  5072.             Real Name (string ending in LINE FEED): the Real Name for
  5073.                 individual users or the group description for group
  5074.                 entries.
  5075.             UserID (one or more strings ending in LINE FEEDS):  The number
  5076.                 of UserID fields is determined by the count at the
  5077.                 beginning of the record.  For individual users, this MUST
  5078.                 be the UserID and Domain for that user.  For group users
  5079.                 this can be a Nickname that points to the real user.
  5080.  
  5081.             For a description of how entries in the Address Book can be
  5082.             created and displayed see the Section VIII, AEMAIL Windows:
  5083.             Address Book window.
  5084.  
  5085.  
  5086.     .signature
  5087.  
  5088.         This is a flat ASCII file that contains the signature block that
  5089.         is to be appended to any composed messages.  Each line of the
  5090.         signature block must end in a LINE FEED.
  5091.  
  5092.         A facility is provided when composing messages to create and or
  5093.         edit this signature block (see the Compose Message window
  5094.         description in Section VIII above).
  5095.  
  5096.  
  5097.     Messages
  5098.  
  5099.         Each message is stored as an individual file with a cryptic file
  5100.         name generated from the File Code in the [Folder_Name].config
  5101.         file.  This name begins with "AE" and ends with "M" with a
  5102.         number of numeric digits in between.  The message is stored as a
  5103.         flat ASCII file as it is received from the POP Server with any
  5104.         CARRAGE RETURNS in a CARRAGE RETURN/LINE FEED sequence stripped.
  5105.         This follows the Amiga format for ASCII files.
  5106.  
  5107.         The complete message is stored along with any attachments as they
  5108.         were orginally received.  Any particular message can be copied
  5109.         to a named file anywhere in your system through the "SAVE MESSAGE
  5110.         TO FILE" command.  If you have an off line program that can
  5111.         process a mime message or a message with UUENCODED attachments,
  5112.         you can use that program against this file to extract the attachments
  5113.         or you can save that attachment directly with the Attachment
  5114.         Requester in the Message Display Window (Section VIII).
  5115.  
  5116.         PLEASE NOTE: if the [folder_Name].config file is deleted you will
  5117.         lose all capability of retrieving your messages unless you have
  5118.         previously copied them to named files.
  5119.  
  5120.  
  5121.     TCP Trace Log File (TCPLOG)
  5122.  
  5123.         This file is present if you have specified
  5124.  
  5125.             TCPLOG=name-of-log-file
  5126.  
  5127.         in the Tool Types parameters or named a "TCP Logging File" in the
  5128.         Default Path Parameters section of the Configuration screen.  Since
  5129.         "name-of-log-file" must be the full path name of the log file,
  5130.         this file may or may not reside in the AEMAIL: directory
  5131.  
  5132.         The TCP Trace Log File traces every TCP transaction.  Each time
  5133.         AEMAIL is started the following record is written to the file:
  5134.  
  5135.             Logging Beginning at DD MMM YR HH:MM:SS
  5136.  
  5137.         where DD is the day of the week, MMM is the month (Jan, Feb, Mar,
  5138.         etc), YY is the 2 digit year (96) and HH, MM, and SS are the
  5139.         hour (24 hour clock), minutes, and seconds.
  5140.  
  5141.         Each logging record will consist of a 38 byte header and up to
  5142.         82 bytes of either descriptive information or actual data received
  5143.         or sent over the TCP interface.  The header consists of a 21 byte
  5144.         date/time stamp (DD MMM YR HH:MM:SS) and 16 byte routine name
  5145.         of the routine in AEMAIL that called the trace.
  5146.  
  5147.         If data is displayed, instances of a CARRAGE RETURN will be
  5148.         displayed as <CR> and of LINE FEEDS as <LF>.  If the data exceeds
  5149.         82 bytes, <---> will be placed at the end of the line.
  5150.  
  5151.         When AEMAIL terminates, or the TCPLOG file name is changed by the
  5152.         Default Path Parameters section of the Configuration screen, the
  5153.         following record is written to the file:
  5154.  
  5155.             Logging Ending at DD MMM YY HH:MM:SS
  5156.  
  5157.         Each AEMAIL session is stacked behind the previous one, so that the
  5158.         file can become quite large.  Periodic purging of the file can
  5159.         occur by deleting the TCPLOG file in between sessions of AEMAIL.
  5160.         Also, a new file is created when you change the name of the TCPLOG
  5161.         file with the Configuration screen.
  5162.  
  5163.  
  5164. X. BUG REPORTS AND SUGGESTIONS
  5165.  
  5166.     Bugs should be reported to:
  5167.  
  5168.         jzachar@calweb.com
  5169.  
  5170.     by email.  You can also use the nickname AEMAIL which has been automatically
  5171.     stored in your address book.
  5172.  
  5173.     In reporting bugs, be as complete as possible in describing the circumstances
  5174.     leading up to the bug.  It would be helpful if you indicate all actions
  5175.     (mouse clicks, etc) that you took before the problem occurred.  If you are
  5176.     having problems connecting to your Internet provider, or sending or receiving
  5177.     mail, you should activate the TCP Log file (See Section IX, AEMAIL FILES:
  5178.     TCP Trace Log File) and send a copy of the log as an attachment to your
  5179.     message.  You might want to block out any password that is contained in
  5180.     the file before you send it to me, however.  You can do that with any
  5181.     text editor.
  5182.  
  5183.     I would also appreciate any suggestions that you have for improving AEMAIL.
  5184.     I will not guarantee that I will accept all suggestions or that I will
  5185.     necessarily implement them in the next release; however, I do take each
  5186.     suggestion seriously.  In the past I have implemented a number of suggestions
  5187.     made by my testers.  I will attempt to respond to each suggestion that is
  5188.     made.
  5189.  
  5190.     In making suggestions keep in mind some of the restraints that I have
  5191.     placed on AEMAIL:
  5192.  
  5193.         (1) The program should be able to be run on any version of
  5194.             AmigaDos 2.1 or greater, and
  5195.  
  5196.         (2) with the exception of AmiTCP, AEMAIL should not require any
  5197.             extension to your system that does not come with a standard
  5198.             AmigaDOS release.  This effectively rules out MUI.  Using an
  5199.             editor of your choice meets this criteria since you can use
  5200.             the standard AmigaDOS editors, ED or MEMACS, which come with
  5201.             the standard AMIGA systems.
  5202.  
  5203.     When reporting bugs or making suggestions, please be as complete as possible
  5204.     in describing the circumstances that brought about the problem or how the
  5205.     suggestion could be implemented.
  5206.  
  5207.  
  5208. XI. REFERENCES
  5209.  
  5210. A number of software packages are mentioned in this documentation.  Details
  5211. on how to obtain these packages are given below:
  5212.  
  5213.     TCP/IP STACKS
  5214.  
  5215.         AmiTCP      A TCP/IP stack for use with the Amiga.  AmiTCP
  5216.                     is copyright (c) 1994, 1995 by Network Solutions
  5217.                     Development, Inc.
  5218.  
  5219.                     AmiTCP was developed by Network Solutions Development,
  5220.                     Inc., P.O. Box 32, FIN-02151 Espoo, Finland.
  5221.  
  5222.                     A demo 4.0 version is available on AmiNet sites in
  5223.                     countries other than USA or Australia.  It can also
  5224.                     be found on many BBS's.
  5225.  
  5226.                     The commercial version is distributed by Village Tronic
  5227.                     Marketing GmbH, Wellweg 95, D-31157 Sarstedt, Germany,
  5228.                     and is available from many Amiga dealers and mail order
  5229.                     houses.
  5230.  
  5231.                     World Wide Web home page for Network Solutions
  5232.                     Development, Inc is:
  5233.  
  5234.                         http://www.xgu.fi/biz/NSDI/
  5235.  
  5236.                     email addresses: info@nsdi.fi
  5237.                                      AmiTCP-Support@nsdi.fi
  5238.                                      AmiTCP-Group@nsdi.fi
  5239.  
  5240.         Miami       A TCP/IP stack compatible with AmiTCP.  This stack
  5241.                     is very simple to install and configure.  Miami is 
  5242.                     copyright (c) 1996, 1997 by Holger Kruse.  It is currently
  5243.                     shareware and is available at
  5244.  
  5245.                         http://www.nordicglobal.com/miami.html
  5246.  
  5247.                     on the WWW or it may be available on local BBS's.  Some
  5248.                     versions are available on AmiNet, but if you want the
  5249.                     latest version consult the web page listed above.
  5250.  
  5251.                     email addresses: kruse@nordicglobal.com
  5252.                                      kruse@america.com
  5253.  
  5254.                     If you are using Miami, the "Down when Offline" item in
  5255.                     the TCP/IP Settings page for Miami should be checked
  5256.                     and your settings saved.  This will prevent Miami from
  5257.                     waiting 80 seconds before returning a failure when you
  5258.                     try to access the Internet when you are "Offline". 
  5259.  
  5260.         TermiteTCP  A TCP/IP stack compatible with AmiTCP.  This stack is
  5261.                     very simple to install and configure.  TermiteTCP is
  5262.                     copyright (c) 1996 by Oregon Research, 16200 S.W. Pacific
  5263.                     Hwy, Suite 162, Tigard, OR 97224.
  5264.  
  5265.                     This is a commercial product available at many Amiga
  5266.                     dealers, mail order houses, or directly from Oregon
  5267.                     Research.
  5268.  
  5269.                     World Wide Web home page for Oregon Research is:
  5270.  
  5271.                         http://www.orres.com/~orres/
  5272.  
  5273.                     email address: support@orres.com
  5274.  
  5275.  
  5276.     WWW BROWSERS
  5277.  
  5278.         Voyager     Copyright (c) 1995-96 by Oiver Wagner.  Voyager 1.0 is
  5279.                     available for download from AmiNet or the
  5280.  
  5281.                         http://www.vapor.com/support
  5282.  
  5283.                     WWW site.  A commercial Version 2.0 is planned but is
  5284.                     not available as yet.
  5285.  
  5286.                     email address: owagner@lsd.wupper.de
  5287.  
  5288.         AWeb        Copyright (c)
  5289.  
  5290.                     Both a public domain demo (AWEB) and a commercial
  5291.                     (AWEB II) version is available.  The public domain
  5292.                     demo version can be found on AmiNet (AWeb v1.2b),
  5293.                     many BBS's, or on the AmiTrix WWW site:
  5294.  
  5295.                         http://www.networkx.com/amitrix/aweb.html
  5296.  
  5297.                     The commercial version (AWEB II) can be obtained from
  5298.                     Amiga dealers or mail order houses.
  5299.  
  5300.                     email addresses: sales@amitrix.com
  5301.                                      support@amitrix.com
  5302.  
  5303.                     Mailing address: AmiTrix Development
  5304.                                      5312-47 Street
  5305.                                      Beaumont Alberta, Canada T4X 1H9
  5306.  
  5307.  
  5308. XII. IN CONCLUSION
  5309.  
  5310. As payment for receiving and using this unregestered BETA version of AEMAIL,
  5311. I would like any bugs, comments, or suggestions reported to me.  You can
  5312. send me email at
  5313.  
  5314.     jzachar@calweb.com
  5315.  
  5316. or use the AEMAIL Nickname created in your Address Book.
  5317.  
  5318. You can also register AEMail for a shareware fee of $30.  See the discussion
  5319. on REGISTRATION under Section II. SYSTEM REQUIREMENTS.
  5320.  
  5321. See the Section X, Bug Reports and Suggestions above for the reporting
  5322. procedure.
  5323.  
  5324. If you give this program to anyone else to use and evaluate, please include
  5325. the complete archive as distributed.  This includes the AEMail program, the
  5326. installation script, and all documentation and readme files.
  5327.  
  5328. The complete archive is being posted on AmiNet and may be posted to any BBS.
  5329. If it is posted to any particular BBS, I would appreciate it if the SYSOP
  5330. of that BBS would send me an email message indicating the BBS it was posted
  5331. to.
  5332.  
  5333. Future versions of AEMail are planned that will implement the following
  5334. features:
  5335.  
  5336.         AREXX Support
  5337.         Filtering incoming messages to specified folders
  5338.         Asynchronous retrieval of messages from a POP server
  5339.         Asynchronous sending of messages to the SMTP server
  5340.         Even faster message display routines with several added features
  5341.             including saving portions of the message to the clipboard
  5342.             and transferring embedded email addresses to the address
  5343.             book.
  5344.         Built in message editor
  5345.         Other features suggested by users
  5346.  
  5347. I have a web site at:
  5348.  
  5349.     http://www.calweb.com/~jzachar
  5350.  
  5351. The latest version of AEMail will be posted to this web site.  Major
  5352. releases will also be posted on AmiNet.
  5353.  
  5354. Whenever a new version of AEMail is available, I will email all users for
  5355. which I have received notification messages (see Registration in Section II) 
  5356. with notice of the new version.
  5357.  
  5358. Thanks,
  5359.  
  5360. John Zacharias
  5361. jzachar@calweb.com
  5362.  
  5363. www: http://www.calweb.com/~jzachar
  5364.  
  5365.  
  5366.